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PREFACE 



This publication, intended for use by 
the system programmer responsible for the 
generation and maintenance of the system, 
is divided into five sections representing 
an introduction, the three logical 
divisions of the system generation process, 
and the flowcharts. 



macro instructions and the APGEN command 
procedure. 



Section 5 contains a set of flowcharts 
to be used in conjunction with the previous 
sections. 



Section 1 is an introduction to the 
system generation and maintenance process 
and provides an overall picture of the 
logic flow from program to program. 

Section 2 explains the SYSBLD phase. It 
presents a brief picture of the SYSBLD 
Prelude routine and an overall picture of 
the SYSBLD process, explaining in detail 
the routines comprising the module. 

Section 3 explains the Startup phase. 
It presents a picture of the Startup 
Prelude and Startup process, including 
Quickstart. Included in the Startup 
description is an introduction to the 
module, a description of the mainline 
routine, a description of the Link- loader 
subroutine a brief explanation of its 
supporting I/O and Link- loader subroutines, 
and a description of the Quickstart 
subroutines. 



Also included in this publication is a 
set of appendixes. These contain 
descriptions of the system table fields set 
by the macro instructions and of the global 
symbols. In addition, all DSECTs that each 
module refers to are listed. 

PREREQUISITE PUBLICATIONS 

Familiarity with the material contained 
in the following publications is essential 
to the use of this manual. 

IBM System/360 Principles of Operation , 
GA22-6821 

IBM System/360 Time Sharing System: 
Concepts and Facilities , GC28-2003 

IBM System/360 Time Sharing System: 
System Generation and Maintenance , 
GC28-2010 



Section 4 contains a brief explanation 
of the SYSGEN phase. It presents the 
relationships of the system generation 



IBM System/360 Time Sharing System: 

System Control Blocks Program Logic 
Manual , GY28-2011 
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SECTION 1: INTRODUCTION 



Figure 1 illustrates the steps involved 
in generation of System/360 Time Sharing 
System (TSS/360) - These steps are: 

1. The user initializes the disks and 
does a dump/ res tore from the input 
tapes which produces an initialized 
disk configuration. 

2. In the SYSBLD phase, the user provides 
minimum machine configuration parame- 
ters to the system, in order that the 
system may generate the required sys- 
tem tables and control blocks, 

3. The user initiates the Startup phase, 
which takes information created during 
the previous (SYSBLD) phase and 
generates a time-sharing system. 
Because the input information is as 
yet limited, the output at this point 
is called a basic time-sharing system. 

4. In the SYSGEN phase, operating within 
this time-sharing enviiconmemt, the 
user initiates execution of a TSS 
Assembler, using the SYSGEN macro 
instructions, with installation- 
dependent parameters as the input data 
set, and creates module as the output 
data set. The user then updates the 
system tables and control blocks, by 
using this SYSGEN module as input to 
the APGEN command procedure. 

5. The user initiates another Startup 
phase, which takes information from 
the previous (SYSGEN) phase and 
generates a time- sharing system. The 
result is now a full-fledged TSS/360 
system. 

This generation of a TSS/360 operating sys- 
tem is accomplished through the use of 
three independent modules, (Prelude, System 
Build (SYSBLD) and Startup) , and the execu- 
tion of two system modules during the Sys- 
tem Generation (SYSGEN) phase (TSS Assembl- 
er and TSS*****. APGEN command procedure) . 



PRELUDE MODULE 

The Prelude module (CEIAP) is loaded 
whenever an initial program load (IPL) 
occurs from the IPL volume. Prelude per- 
forms a configuration analysis, and then: 

1. Locates the required SYSBLD or Startup 
module. 



2. Reads the required module from disk 
into main storage. 

3. Transfers control to the required 
module. 

Since Prelude's initial function is to load 
SYSBLD, Prelude in its original state on 
the IPL tape is referred to as SYSBLD 
Prelude. 

The Prelude program flow for the SYSBLD 
process is: 

1. The SYSBLD Prelude is loaded from the 
IPL volume. 

2. SYSBLD Prelude loads SYSBLD and exits 
to it. 

3. At the completion of SYSBLD, SYSBLD 
permanently modifies SYSBLD Prelude to 
locate and read Startup. SYSBLD then 
writes Prelude back on disk. From 
this point on Prelude is known as 
Startup Prelude. 

The Prelude program flow for the Startup 
process is: 

1. The Startup Prelude is loaded from the 
IPL volume. 

2. Startup Prelude loads Startup, and 
exits to it. 

The Prelude module is described in detail 
at the beginning of Section 3, Startup 
Phase, and is briefly described as it ap- 
plies to SYSBLD at the beginning of Section 
2. 



SYSBLD MODULE 

The SYSBLD module (CEIFA) is independent 
of system programs. SYSBLD functions in 
main storage as a no n- reenterable auxiliary 
module making up a group of stand-alone 
routines. Running in a nonconversational 
environment, its main function is to pro- 
vide information that Startup can use to 
initialize a basic time- sharing system (of 
minimum machine configuration) . 

Initially SYSPLD locates the operator's 
terminal and interrogates the operator for 
minimum system parameters. This data is 
used to update tha existing Pathfinding 
tables, the Symbolic Device Allocation 
table (CHBSDA) , the Available Devices 
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Figure 1. Program Flow of Typical 2311 System Generation Process 



tables (CHBAHD, CHBHED, CHBAVE) , the System 
Common table (CHBSCM) and the Configuration 
Control Block (CHBCCB) . Next are created: 
a system user table (SYSUSE) , a system 
catalog (SYSCAT) and a user library (USER- 
LIB for SYSOPERO, SYSMANGR and TSS*****) . 
Finally the SYSBLD Prelude module is 
changed to Startup Prelude and written back 
on disk. SYSBLD finishes with an operator 
message telling the operator to reload from 
the IPL volume. 

SYSBLD is described in detail in Section 
2. See Chart AA f Page 2. 



Virtual storage. It creates a set of spe- 
cial device paths, sets protection keys and 
starts other CPUs in a multi-CPU environ- 
ment. It also creates the Main Operator 
Task (MOT). 

Once the initialization is complete, the 
system is given control as Startup exits to 
the Queue Scanner. At this point an oper- 
able time-sharing environment exists. 

Startup is described in detail in Sec- 
tion 3. 



STARTUP MODULE 



SYSGEN PHASE 



The Startup module (CEIAA) operates out- 
side the TSS/360 environment. It is 
executed under the control of a main- line 
routine. This routine makes use of several 
independent routines, each with a specific 
function. Startup generates a basic time- 
sharing system, a full-fledged system, or 
is used to restart the system after 
encountering an error from which recovery 
cannot be made. Only after Startup has 
completed its processing can the user work 
within the structure of a time-sharing sys- 
tem environment. 

Startup initializes the system by set- 
ting up tables such as the Shared Data Set 
table (SDST) , the Core Block table (CBT) , 
and the Extended Task Status Index (XTSI) . 
It constructs a Task Dictionary (TDY) for 
the dynamic loader; prints the storage map 
for Initial Virtual storage (SYSIVM), the 
Resident Supervisor (RESSUP) and the Resi- 
dent Support System (RSSSUP); and link- 
loads the Resident Supervisor and Initial 



The SYSGEN. MODULE data set is generated 
under a time-sharing system when system 
generation macro instructions are assembled 
under the TSS/360 Assembler. The resulting 
SYSGEN. MODULE data set is composed of sys- 
tem tables and control blocks, and contains 
configuration and installation data. 

These SYSGEN- produced tables are then 
incorporated in the existing time- sharing 
system to initialize a tailored TSS/360. 
This is accomplished by applying SYSGEN- 
produced control sections to the existing 
system tables via the command language and 
linkage editor control statements contained 
in the TSS*****.APGEN command procedure. 
After updating the system tables in place, 
the TSS/360 must be shut down, so that a 
Startup sequence from the IPL volume can be 
initiated in order to use the TSS/360 
operating system. 

The SYSGEN phase is described in Section 
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SECTION 2: 



SYSBLD PHASE 



SYSBLD PRELUDE (CEIAP) 

Entry to the system build and generation 
process is accomplished by loading the IPL 
volume disk, which reads the SYSBLD Prelude 
routine. Aside from normal functions, SYS- 
BLD Prelude allocates space dynamically for 
a fifty-eight page buffer area to be uti- 
lized by SYSBLD. The SYSBLD Prelude reads 
the SYSBLD data set off the disk, and 
branches to the first instruction, thus 
giving it control. A general register 
points to a parameter list consisting of 
the following adcons : 



Word 
Word 1 
Word 2 
Word 3 
Word ** 



address of the data set name to 

be located. 

address of the data set name in 

error message 1. 

address of the data set name in 

error message 2. 

address of the field containing 

operator's terminal address. 

address of byte switch to be 

zeroed. 



These fields are changed during SYSBLD 
execution to produce the Startup Prelude on 
the same IPL volume. This module is 
described in greater detail under the head- 
ing "Startup Prelude" (Chart AB) . 



SYSBLD (CEIFA) 



Chart AA 

SYSBLD, one stand-alone module, consists 
of several routines that pass control among 
themselves. The initializing routine sets 
the base register for the program, and con- 
trol is passed from one routine to another 
through the use of adcons. A general 
register always points to the common save 
area of SYSBLD, the nineteenth word of 
which contains the SYSBLD table address. 
Thus the table is addressable by all the 
SYSBLD routines. Among these routines are 
a set of service routines called by the 
main routines. These do such jobs as I/O, 
allocating space, and converting external 
page numbers. Chart AA, Page 2 shows the 
general flow of control from routine to 
routine. If any error conditions arise in 
the service routines, a general register is 
set with a hexadecimal error code and con- 
trol is returned to the calling routine. 
This in turn sends control to the Terminat- 
ing routine. 

SYSBLD operates in main storage, outside 
the time-sharing environment, as a nonrelo- 



catable, stand-alone module. It is entered 
through the SYSBLD Prelude. 



Input to SYSBLD is made up of the fol- 
lowing (see Figure 2) : 



1. Two disks restored from IBM-supplied 
tapes. 

a. Initial program load (IPL) VAM- 
formatted disk with SYSBLD Prelude 
record. 

b. Auxiliary control volume CACV) 
VAM- formatted disk. 

2. Information on device type and address 
as entered by the system operator 
through his terminal. 

The following are tables updated by 
SYSBLD: 

1. Data set TSS***** .RESSUP. GOOOOVOO 

In this data set the addresses of 

five disks (IPL, ACV, public, auxi- 
liary, private) 
operator's terminal 
system programmer terminal 
printer 
card reader 

are placed in the Pathf inding tables 



CHBSAC 
CHBDEV 
CHBMCH 



CHBSCH 
CHBCHL 



In addition, the table CHBTDE is 
updated for device code. 

2. Data set TSS*****. RSSSUP. GOOOOVOO 

In this data set the following table 
is updated: 

CHBECXRB 

3. Data set TSS*****. SYSIVM. GOOOOVOO 

In this data set the following tables 
are updated: 



CHBSDA 
CHBAHD 
CHBAVE 



CHBSCM 

CHBECXVA 

CHBBCT 



4. Data set TSS*****. SYSCCB. GOOOOVOO 



INPUT 



OUTPUT 




1052 



ACV 



TSS*****.SYSCCB 
TSS*****. STARTUP 
TSS*****. SYSBLD 
TS S*****.RESSUP 
TSS*****.SYSIVM ■ 
TSS*****.RSSSUP 



TSS Password and Charge Number 
System Programmer Fassword 

and Charge Number 
System Programmer Terminal Address 
System Programmer Terminal Type 
ACV Device Address 
System Programmer Device Type 
Public Disk Address 
Private Disk Address 
Auxiliary Paging Disk Address 



I PL 
^Startup Prelude 



TSS***** 


.ASMMAC 


TSS***** 


.ASMNDX 


TSS***** 


.SYSL1B 


TSS***** 


.SYS MAC 


TCC***** 


.MACNDX 


TCC***** 


.APGEN 




*TSS*****.SYSCCB 

TSS*****. STARTUP 

TSS*****.SYSBLD 

*TSS*****.RESSUP 

*TSS*****.SYSIVM 

TSS*****.RSSSUP 



TSS*****.ASMMAC 

TSS*****. ASMNDX 
*TSS*****.SYSCAT 

TSS*****.SYSLIB 

TSS*****.SYSMAC 

TSS*****. MACNDX 
*TSS*****. APGEN 
*TSS*****.SYSUSE 
*TSS*****.USERLIB 

TSS*****.SYSSVCT 
*SYSOPERO.USERLIB 
*SYSMANGR.USERLIB 

*Indicates change or addition 



Figure 2. SYSBLD Inputs and Outputs 



The Configuration Control Block is 
filled in as follows: 

Drum table with drum path 
Transmission Control Path table 

with system programmers terminal 

and line type 
Printer table with printer path 

SYSBLD also creates six new data sets on 

the ACV volume. 

1. A user table with entries for the 
operator and manager. 

2. A user library for user TSS***** con- 
taining no entries. 

3. A user library for user SYSOPER0 con- 
taining no entries. 

4. A user library for user SYSMANGR con- 
taining no entries. 

5 . A catalog containing the following 
data sets for the user TSS*****: 



STARTUP 

RESSUP 

SYSIVM 

SYSCCB 

SYSBLD 

RSSSUP 

SYSUSE 



SYSLIB 

SYSMAC 

MACNDX 

USERLIB 

APGEN 

ASMMAC 

ASMNDX 



and for the user SYSOPER0: 

SYSLOG 
USERLIB 

and for user SYSMANGR: 

USERLIB 

6. A library for user catalogs 
(TSS*****.SYSSVCT) . 

Output from SYSBLD is in the following form 
(see Figure 2) . 

Two updated disks: 
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a. IPL disk with Prelude record 
changed to read Startup and three 
data sets modified. 

b. ACV disk with six new data sets. 

A work area called CHASBD is created by 
SYSBLD, and is used as the common data area 
for all steps in the program. 

At a successful conclusion of SYSBLD, a 
message is sent to the operator informing 
him that the program is complete, and 
instructing him to load the IPL volume to 
run Startup. The machine is put in the 
WAIT state. If an error exit occurs, an 
appropriate message is produced and the 
machine is forced into the WAIT state. All 
the SYSBLD routines are described in detail 
below. 



UPDATE GROUP 

Initialization Routine (CEIFA) 

Chart AA, Page 2 

The purpose of this routine is to create 
and initialize the SYSBLD table (CHASBD) , 
and make it accessible to all SYSBLD rou- 
tines. Addressability is set up, base 
registers assigned, a common save area 
allocated, and CHASBD addressed in the 19th 
word of the area. Also at this time, the 
fifty-eight page buffer (allocated by Pre- 
lude for SYSBLD) is zeroed out. 

On entry, a general register contains a 
pointer to the fields in SYSBLD Prelude 
that must be changed to load Startup. This 
pointer and the operator's path are stored 
in the table. The IPL path is extracted 
from the IPL program status word (PSW - 
found in location in storage) and saved 
in the table. The Disk I/O routine (CEIFS) 
is called to read the IPL volume label and 
from this, the volume ID and relative page 
number of the Page Assignment table (PAT) 
are saved. The disk type and number of 
pages per volume, determined by examining 
the volume label, are set in the table. 

In the event an error is encountered, a 
general register is set with an error code, 
and control is sent to the Terminating rou- 
tine, (CEIFK) . On a normal exit, control 
is sent to the Convert Paths routine. 

Convert Paths Routine (CEIFP) 



Chart AA, Page 3 

The purpose of this routine is to adjust 
the operator's terminal path and the IPL 
path for the checking of operator messages. 
On entry, the terminal path (stored in the 
SYSBLD table) is converted from binary to 



EBCDIC, and is stored back in the table in 
the form of control unit and device. The 
IPL path, saved previously by Prelude, is 
read, converted to EBCDIC in channel, con- 
trol unit, and device form, and is 
restored. Control is sent to Interrogate 
Operator routine. 

Interrogate Operator Routine (CEIFB) 

Chart AA, Page 3 

This routine interrogates the system 
operator for various system parameters, 
examines his replies for validity, and 
rejects any erroneous responses. Upon 
entry, the user's terminal path is in a 
parameter register. At this point the sys- 
tem is running in the supervisor state, 
external interruptions are disabled, and 
the PSWs are set to handle machine check 
and program interruptions. 

This routine moves a message to the ter- 
minal output area, selects the write-to- 
operator with reply option, and calls the 
Communicate With Operator routine (CEIFR) . 
Once control is returned, the terminal out- 
put area is examined for a valid reply. If 
acceptable, the reply is stored as an entry 
in the SYSBLD table. Then the next message 
is moved in, and the process continues 
until all parameters are read in. The rou- 
tine requests the operator's and manager's 
passwords and charge numbers, the system 
programmer's terminal address and feature 
(dedicated versus dial-in) , the ACV, pri- 
vate, public, and auxiliary device 
addresses, the printer path, and the card 
reader path. 

If an erroneous reply is encountered, an 
appropriate diagnostic message is sent out 
on the terminal with the write- to-operator 
option selected. Control is then sent back 
to re- execute the original request, and the 
new reply is received or an I/O error 
occurs. If an error occurs, control is 
sent to CEIFK. On a normal exit control 
goes to the Complete SYSBLD Table routine. 

Complete SYSBLD Table Routine (CEIFC) 

Chart AA, Page 4 

This is a housekeeping routine to com- 
plete the SYSBLD table, and get the ACV 
volume ID and relative page number of the 
PAT. This routine also reads the IPL and 
ACV PATs into a buffer following the SYSBLD 
table. The following table entries, having 
been obtained by CEIFB, are now converted 
from EBCDIC to hexadecimal notation, and 
restored in CHASBD: 

System Programmer's terminal control 

unit 
Common disk channel 



Common disk control unit 

ACV device 

Private, public, auxiliary paging disk 

devices 
Drum channel 
Drum control unit 
Drum device 
IPL device 

Printer and card reader control unit 
Printer device 
Card reader device 

plus the paths created to tie: 

ACV device 

Private, public, auxiliary paging disks 

Printer 

Next, the ACV path is set in a parameter 
register. The volume label CCHHR is set in 
a parameter list. The Disk I/O routine 
(CEIFS) is called with option '00" to read 
the volume label. On return, the volume ID 
and the relative page number of the PAT are 
set in the table. The PATs for the IPL and 
ACV volumes are read and moved into buffers 
following CHASBD. 

On return from CEIFS, if general regist- 
er 15 is nonzero, an error has occurred and 
control goes to the Terminating routine. 
On a normal exit, control passes to the 
Adjust DSCBs routine. 

Adjust DSCBs Routine CCEIFQ ) 

Chart AA, Page 4 

The purpose of this routine is to insure 
that every precataloged generation data 
group has a DSCB with generation 0, version 
0. On entry, CEIFQ gets the address of the 
IPL PAT buffer, scans the PAT for DSCB 
pages, and reads each DSCB page into an I/O 
area. It tests every DSCB on the page and 
changes the format of the generation data 
group DSCBs from GxxxxVyy to G0000V00. For 
each page on which modifications were made, 
CEIFS (DISK I/O) is called to rewrite that 
page. Once the IPL volume is complete, the 
same procedure is followed for the ACV 
volume. At completion, control is sent to 
the Update Pathfinder routine. 

Update Pathfinder Tables Routine (CEIFD) 

Chart AA, Page 5 

This routine updates the Pathfinder 
tables to show the actual device paths to 
the devices listed. Specifically, the fol- 
lowing ten devices are entered in the 
tables in this order: 

Drum 

IPL disk 

ACV disk 

Private, public, auxiliary paging disks 



Operator's terminal 

System programmer's terminal 

Printer 

Card reader 



It is assumed that each table, or group 
of tables, will be in a separate CSECT, and 
no CSECT will exceed a page in length. 
First the Find DSCB routine (CEIFDS) is 
called to find and read the format-E DSCB 
for data set TSS*****.RESSUP.G0000V00. On 
return, the number of data set and direc- 
tory pages is stored from the DSCB. The 
Create List of Pages routine (CEIFV) is 
called to prepare a list, arranged in vir- 
tual page order, of all the external pages 
containing the data set. 



Using the number of directory pages as a 
count, starting at the beginning of the 
list, each page in turn is selected and the 
Page Convert routine (CEIFL) translates it 
to CCHHR. Then, again using CEIFS, the 
record is read and moved 256 bytes at a 
time into the POD/PMD area. The procedure 
is repeated until the page count is zero. 
The search routine for the POD, Locate 
Descriptor in POD (CEIFU) , is called to 
locate the module containing the Pathfinder 
tables by using the name of one of the 
tables. 



The relative page number field, located 
in the first page of the member descriptor 
module (POMFP) , is used as an index to the 
list of external pages in order to select 
the corresponding external page number. 
Using CEIFL, the number is converted. 
CEIFS is called to read the record contain- 
ing the PMD, and this record is moved to 
the POD/PMD area. 



A field in the header is examined to 
determine the size of the PMD. If it is 
longer than one page, successive external 
page numbers are selected from the list. 
Again the number is converted, the record 
read and moved contiguously into the POD/ 
PMD area, until the entire PMD has been 
read and set up. 



Next the Locate DEF routine (CEIFT) is 
called, and the CSECT containing the Sym- 
bolic to Actual Conversion table (CHBSAC) 
is located. The relative page number of 
the CSECT (output of CEIFT) is used as an 
offset, from the start of the member in the 
list of external pages, to pick up the 
external page number of the CSECT. The 
number is converted, and the Disk I/O rou- 
tine reads the record. CHBSAC is set up 
for the previously listed devices. 
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SYSBLD sets the device number (last 4 
bits of the path) in the device address 
field for each entry- The record contain- 
ing the table is written. 



Again the CEIFT routine is called to 
locate the CSECT containing the device 
group tables, using CHBD0316, the name of 
the Drum table. The relative page number 
of the CSECT is used to locate the external 
page number containing the table; the num- 
ber is converted, and the record read. The 
value of the DEF, a binary number, is used 
as an offset, from the beginning of the 
page, to access the correct table. Bits 
0-7 of the 13-bit drum path are stored in 
the first device path byte (DEVPP) ; bit 
of the additional path byte (DEVLB) is set 
to reflect bit 8 of the path. (Bits 9-12 
of the path constitute the device number 
and were stored in CHBSAC. This table also 
has the pointers to the relevant device 
group tables set up at SYSGEN time.) The 
device number (bits 9-12 of the path) is 
used as an index to select the correct 
device entry in the table; the symbolic 
device address, 1 for the drum, is set up, 
and the available flag set off. Since only 
one drum type is possible, every device 
entry is set up during SYSGEN with this 
device type. 



The Locate DEF routine is called to find 
the location of the Disk Device Group 
table, CHBD216, and the value, a binary 
number, is used as an offset from the 
beginning of the page to access the correct 
table. The DEVPP field is set with bits 
0-7 of the disk path and bit of DEVLB set 
to reflect bit 8 of the path. Bits 9-12 of 
the path to each disk will be different, 
since all five disks are separate devices 
on the same channel and control unit. For 
each device in turn, bits 9-12, the device 
numbers, are used to select the correct 
device entry. The device type field is set 
to reflect the disk type — '01' for 2311 
and '04' for 2314 — and the symbolic 
device address is inserted. This is X'09' 
for the IPL, X'OA' for the ACV, X'OB' for 
the private disk, X'OC for the public 
disk, and X'OD' for the auxiliary disk. 



Locate DEF is called to find CHB0101, 
the Operator's Terminal Device Group table. 
The DEVPP, and bit of the DEVLB, are set. 
The device number of the operator ' s termin- 
al is used to locate the correct device 
entry, the flag set off and the symbolic 
device address, X'OE* for the operator, is 
set up. Again, the operator must use a 
1052 Model 7 so the device type can be set 
up for every entry. 



The System Programmer's Terminal Device 
Group table is located (CHB0111) , and DEVPP 
and DEVLB are set. The correct device 
entry is selected, the flag set off, and 
the symbolic device, X'OF' for the system 
programmer's terminal, inserted. The same 
procedure is followed for the printer and 
card reader. CHBD0114 is located and the 
flags set to X'10" and X'll' respectively. 
The entire page is then rewritten. 



The subroutine CEIFT is called to find 
the CSECT containing the terminal device 
table, CHBTDE, and read it into main 
storage. The administrator's terminal 
entry is updated to contain the device code 
which was determined from the input to SYS- 
BLD. The updated table is rewritten to 
disk. 



CEIFT is called to find the CSECT con- 
taining the Channel table, CHBCHL. The 
relative page number of the start of the 
CSECT is again used to select the correct 
external page number; the number is con- 
verted and the record read. The table is 
constructed by SYSGEN with the channel 
pointer set up to point to the control 
units assigned to the multiplexer channel, 
and dummy pointers set up for the selector 
channels. The size of the control units 
assigned to the multiplexer table is set up 
in the flag area corresponding to channel 
0, and the flag set off. The disk channel 
number, bits 0-4 of the path, is used to 
select the correct byte pair for the disk 
channel; the flag is set off, and the sele- 
ctor channel size inserted. Similarly, the 
byte pair corresponding to the drum channel 
number is selected, the flag set off, the 
table size inserted, and the record 
rewritten. 

SYSGEN Minimum Tables creates a CSECT 
CHBSCH. CHBS2 and CHBS3 are entry points 
at relative bytes zero and sixty- four 
respectively. Hence the displacements for 
the disk and drum channels are known. 
These displacements are inserted in the 
channel table for the actual channel 
address of the disks and drum. 

Locate DEF is called to locate the CSECT 
containing the control units assigned to 
the Multiplexer Channel table, CHBMCH; the 
page number is selected and converted, and 
the record read. The operator's terminal 
control unit, bits 5-8 of the path, is used 
as an offset to select the correct entry, 
and the flag set off. The displacement 
field is saved. The system programmer's 
terminal control unit is similarly used to 
select the correct entry and the flag set 
off. The displacement in this entry is set 
to one more than that of the operator's 
terminal. Similarly, the printer displace- 



merit is set to one more than that of the 
system programmer's terminal. The record 
is then rewritten. 

The Control Unit table, using relevant 
entries to which these displacements refer, 
is assembled by SYSGEN, with two contiguous 
entries for the multiplexer units, the sys- 
tem programmer's terminal control unit 
being second. CEIFT is called to find the 
CSECT containing the two control units 
assigned to selector channel tables, using 
CHBS3, the Disk table. The page number is 
selected and converted, and the record 
read. The value of the DEF, CHBS2, is used 
to locate the correct table in the page. 
The value of the disk control unit is used 
to select the correct entry in the table 
and the flag set off. This table is 
assembled with all displacements pointing 
to the disk control unit in the Control 
Unit table. CEIFT is called to find the 
value of CHBS2, the entry point of the con- 
trol units assigned to the Drum Selector 
Channel table, and the value used to select 
the correct table in the page. The value 
of the drum control unit is used to select 
the correct entry in the table and the 
flag, bit 1 of the first byte, set off. 
Again all displacements are set up by SYS- 
GEN. The record is rewritten, and control 
passed to the next routine. 

If any of the subroutines called detects 
an error condition, it sets an error code 
in a register. The CEIFD routine inspects 
the register on return from every subrou- 
tine called. If an error code is found, 
processing is stopped and control passed to 
the Terminate routine. Unless the error 
occurred when writing on the disk, proces- 
sing can be restarted from the beginning of 
SYSBLD regardless of where In the routine 
the error occurred. 

At completion, control is passed to the 
RSS Update Device Tables routine (CEIFRS1) , 
which modifies the Update Pathfinder Tables 
routine (CEIFD) and branches back to the 
beginning of CEIFD. Upon completion of 
this modified routine (CEIFD) control is 
passed to the VSS Update Device Tables rou- 
tine (CEIFRS2) which again modifies the 
Update Pathfinder Tables routine (CEIFD) 
and again branches back to the beginning of 
CEIFD (see details of RSS/VSS in the sec- 
tion under Service Routines). Control then 
passes to the Update Virtual Memory Tables 
routine. 

In addition to the above Update Path- 
finder routines, the following steps are 
executed if the operator's console (1050-7) 
has the same control unit address as the 
28 21 control unit. 

• A flag is set in the Device Group 
table, CHBDEV, to allow asynchronous 



interruptions for the operator's con- 
sole device (1050-7). 

• The "dummy entry" in the Control Unit 
table, CHBCUT, for the 2821 is parti- 
tioned out. 

• Entries for the card reader and printer 
in the Device Group table formerly on 
the "dummy" 28 21 are now located along 
with the entries for the operator's 
console on that particular 2821. 

• The "displacement" for the printer in 
the Multiplexer Channel table, CHBMCH, 
is now set to equal that of the opera- 
tor's terminal control unit. 



Update Virtual Memory Tables Routine 
(CEIFG) 

Chart AA, Page 6 

This routine updates information in the 
following tables: Symbolic Device Alloca- 
tion table (CHBSDA) , Availability table and 
its header (CHBAVE and CHBAHD) , and System 
Common (CHBSCM) . 

Upon entry, general register contains 
the IPL path. The Find DSCB routine 
(CEIFDS) is called to read the DSCB per- 
taining to the TSS*****.SYSIVM.G0000V00 
data set. This DSCB is moved into the 
beginning of the I/O area, and the number 
of directory (POD) pages is saved. A list 
of external pages for the data set is 
created, by calling the Create List of 
Pages routine (CEIFV) . 

For each table to be processed, the POD 
page addresses are converted (by CEIFD, 
read, and moved to the POD/PMD area. The 
POD is searched for the member to be pro- 
cessed. The first page of PMD is read to 
determine the PMD length. The remaining 
PMD pages are then read and moved to the 
POD/PMD area. The PMD is searched for the 
definition of the table, and the CSECT is 
located and read into the common I/O area. 

The tables are updated in the order 
CHBSDA, CHBAHD, CHBAVE, and CHBSCM. After 
each update, the table is rewritten on the 
IPL disk and the next table processed. 

Control is sent to the Terminating rou- 
tine in case of an error return. Normally, 
control is sent to the Update Configuration 
Control Block routine. 

A description of the table updating 
follows : 

CHBSDA z The five disk entries for SDA 9, 
A, B, C, D are set to the proper device 
code, 2311 or 2314. The system program- 
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mer B s terminal entry (SDA E) device code is 
set for the correct device type. 

CHBAHD: The device code for the five disks 
is set to either 2311 or 2314. 

CHBAVE: The device code for each of the 
five disk entries is set to 2311 or 2314. 

CHBSCM: The default for disks is set to 
2311 or 2314. The count of disks of the 
type being used is set to five and the 
count field for the type not being used is 
set to zero. 

Update Configuration Control Block Routine 
(CEIFI) 

Chart AA, Page 7 

The purpose of this routine is to insert 
the actual disk and drum addresses and ter- 
minal data in the relevant parts of the 
Configuration Control Block. On entry, the 
IPL path is set in general register 0. The 
IPL volume is searched (via CEIFDS) for the 
DSCB pertaining to the data set TSS*****. 
SYSCCB.G0000V00. This DSCB is then moved 
into the beginning of the I/O area and the 
number of directory pages is saved. A list 
of external pages for the data set is 
created by CEIFV. As in previous routines, 
the POD page or pages are converted, read, 
and moved to the POD/PMD area. Next the 
POD is searched for member CHBCCB. The 
first page is read to determine the length 
of the PMD. The remaining pages are read 
and moved to the POD/PMD area. Now the 
definition is located, the CSECT found and 
read into a common I/O area. 

The drum path is set in the Drum Path 
table. The Transmission Control Path table 
is updated for the administrator terminal. 
The path is inserted and the type and SAD 
ORDER set from information stored in the 
SYSBLD table. The printer path is set in 
its table. The Channel Control Unit table 
is set for two selector channels and the 
page is rewritten. 

Normal control is sent to the Create 
User table routine. Any errors encountered 
are resolved by the Terminating routine, to 
which control is given with appropriate 
codes set. 



CREATE NEW DATA SET GROUP 

The following four routines are run, one 
after another, to create five data sets 
needed by system generation. The User 
table, three user libraries, the User Cata- 
logs Control Block (SYSSVCT), and a scratch 
catalog (SYSCAT) , containing members for 
SYSOPER0, TSS***** and SYSMANGR are set up. 
Addressability is provided for these stored 



tables, and in each routine a general 
register contains the ACV path. 

Create User Table Routine (CEIFE) 

Chart AA, Page 8 

This routine inserts the passwords and 
charge numbers for the system manager and 
system programmer, with the user identifi- 
cations, in a stored User table. The rou- 
tine also writes out the table and con- 
structs a DSCB for the data set. The pass- 
words, stored in the SYSBLD table, are 
inserted in the User table at their respec- 
tive entries. The operator's entries are 
prestored. The Assign External Space rou- 
tine (CEIFW) is called to allocate 14 pages 
of external space for the catalog. User 
table, SYSSVCT (User Catalogs Control 
Block), and three user libraries. The 
fifth page number is converted, and the 
User table is written on the disk. The 
thirteenth page, SYSSVCT, and the four- 
teenth page, the SYSSVCT VISAM directory, 
are converted and written on the disk. 

The eighth page number is converted, and 
a VISAM directory page is written on the 
disk. The directory page has all zeros, 
with the exception of the first fullword, 
which contains a 1. 

Next, the physical limits are set up in 
the stored data set DSCB, the address of a 
zero DSCB is obtained and the User table 
DSCB is written in that area. Normal exit 
is to the Create Catalog routine. 

Create User Library (CEIFZA) 

Chart AA, Page 8 

This routine uses the sixth and seventh 
pages obtained previously from CEIFW, and 
creates a DSCB for TSS*****. USERLIB from 
them. These pages are flagged as assigned, 
but are not in use. CEIFZA also creates a 
DSCB for SYSOPER0. USERLIB (using the tenth 
and eleventh pages) and a DSCB for 
SYSMANGR. USERLIB (using the ninth and 
twelfth pages). The DSCBs are then written 
on the ACV. Control goes to the Create 
Catalog routine. 

Create Catalog Routine (CEIFF) 

Chart AA, Page 8 

This routine updates the volume ID 
fields of the ACV and IPL volumes in the 
previously assembled catalog. The volume 
ID field for the IPL volume is initialized 
with the volume ID of the IPL pack. The 
volume ID field for the ACV is zeroed out. 

The address of the IPL or ACV volume is 
stored in register and CEIFECAT is called 
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to develop the address of the DSCB for that 
data set, CEIFECAT stores the address of 
the DSCB in a field CCCDPT in the Catalog 
SB LOCK. The DSCB address is in the form 
SOOOPPPP. S is the slot number, OOO is the 
relative volume number of the ACV, and PPPP 
is the relative page number on which the 
DSCB is located. 

Four external pages that were obtained 
in the Create User table routine are used 
for the catalog. The POD is written on 
page one. The catalog entries for SYS- 
OPERO, TSS*****, and SYSMANGR are written 
on the second, third, and fourth pages 
respectively. The DSCB is then written on 
the ACV. 

Normal exit goes to the Update Catalog 
JFCB routine. As in other routines, 
abnormal exit goes through the Terminating 
routine. 

Update Catalog JFCB Routine (CEIFTD) 

Chart AA, Page 9 

This routine places a pointer to the 
Catalog format-E DSCB in the catalog Job 
File Control Block ( JFCB) . 

First, the Find DSCB routine is called 
to read the format-E DSCB for TSS*****. 
SYSIVM.G0000V00. On return the number of 
data set and directory pages are stored 
from the DSCB. The Create List of Pages 
routine (CEIFV) is called to prepare a list 
of all the external pages containing the 
data set (in virtual page order) . 

Using the number of directory pages as a 
count, starting at the beginning of the 
list, each page in turn is selected and the 
Page Convert routine (CEIFL) translates it 
to CCHHR. Then, again using CEIFS, the 
record is read and moved 256 bytes at a 
time into the POD/PMD area. The procedure 
is repeated until the page count is zero. 
The search routine for the POD, Locate 
Descriptor in POD (CEIFU) , is called to lo- 
cate the module containing the TDT by using 
the CSECT name CHBTDT. 

The relative page number field, located 
in the first page of the member descriptor 
module (POMFP) , is used as an index to the 
list of external pages in order to select 
the corresponding external page number. 
Using CEIFL, the number is converted. 
CEIFS is called to read the record contain- 
ing the PMD, and this record is moved to 
the POD/PMD area. 

A field in the header is examined to 
determine the size of the PMD. If it is 
longer than one page, successive external 
page numbers are selected from the list. 
Again the number is converted, the record 



read and moved contiguously into the POD/ 
PMD area, until the entire PMD has been 
read and set up. 

Next the Locate DEF routine (CEIFT) is 
called, and the CSECT CHBTDT is located. 
The relative page number of the CSECT (out- 
put of CEIFT) is used as an offset, from 
the start of the member in the list of 
external pages, to pick up the external 
page number of the CSECT. The number is 
converted, and the Disk I/O routine reads 
the record. 

The pointer to the last JFCB is 
obtained. CEIFTD chains backwards through 
the JFCBs until the Catalog JFCB is encoun- 
tered. When the Catalog JFCB is found, the 
slot number and page number of its format-E 
DSCB are moved from the SYSBLD table into 
the TDTDSC field in the JFCB. Chaining 
continues through the last DSCB. 

CEIFS is called to rewrite the TDT page. 
Control is passed to the Terminating rou- 
tine if any called subroutine returns an 
error code in general register 15. Other- 
wise, control is passed to the Set Up 
Volumes for Startup routine (CEIFJ) . 



COMPLETION GROUP 

Set Up Volumes for Startup Routine (CEIFJ) 

Chart AA, Page 10 

The purpose of this routine is to 
rewrite the PAT, and modify the SYSBLD Pre- 
lude into a Startup Prelude. The two PATs, 
one for the IPL volume and one for the ACV 
volume, are located in main storage follow- 
ing the SYSBLD table. They are moved to 
the disk I/O area and CEIFS is called (with 
the path and parameter area set up) to 
write them onto the ACV. If the disk rou- 
tine returns a nonzero register, the Ter- 
minating routine is called. Otherwise, the 
Prelude record is read from the IPL volume. 
The displacements of the fields to be 
changed (previously stored in the SYSBLD 
table) are obtained, and the contents 
changed. A parameter area is set up and 
the disk routine called to write the new 
Prelude over the SYSBLD Prelude on the IPL 
volume. Control is then passed to the Ter- 
minating routine with a normal completion 
code. 

Terminating Routine (CEIFK) 

Chart AA, Page 10 

This is the routine that handles the 
termination of SYSBLD. It interprets the 
error codes sent in general register 15, 
and sends out a proper message. Following 
is a list of codes and their meanings: 
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00' 


error free 


FO - 


machine check interruption 


F4» 

80* 


program interruption 
terminal I/O error 


40" 


disk 


I/O error 




•41» 


read 




«48' 


write 




• 43 . 


format- E not found 


20 s 


data 
■21' 


processing error 
data set not found 




f 22 f 


member not in POD 




f 23' 


list of external pages 




'24' 


incomplete 

invalid channel for IPL 




• 25» 


erroneous path (not IPL or 
AUX) 


10 f 


table is already present 
•ll* user table 




, 12 i 


catalog 
userlib 


08' 


restore disks before restarting 



On a terminal I/O error, the message is 
suppressed. Otherwise, a correct message 
is moved into the message write area, and 
the Message Write routine (CEIFR) is called 
to write the message on the terminal. On 
return from writing the error message, the 
machine is put in the WAIT state, with the 
EBCDIC for "END" in the display register 
Cd-register) . If this was code f 00», SYS- 
BLD is now complete. If not, SYSBLD must 
be rerun. 



SERVICE GROUP 

Locate DEF Entry Routine (CEIFT) 

Chart AA, Page 12 

This routine is called to locate the 
value of a DEF, the start of the CSD con- 
taining the DEF, and the page number in 
text of page of the CSECT. All DEFs 
called for must be simple, relocatable 
DEFs. When the routine is entered, general 
register contains a pointer to a parame- 
ter list. The PMD is in main storage. 
Word of the parameter list contains the 
address of the PMD, and word 1 the address 
of an eight- byte area containing the name 
to be located. The machine is in the 
supervisor state, and running with all 
interruptions disabled. 

In order to locate the first CSD, the 
routine will add the length of the PMD 
header field to the PMD start address. 
Then, to locate the first DEF, it will add 
the CSD header length to the start address 
of the CSD. Next, every relocatable DEF 
name will be compared to the eight- byte 
field in the parameter list until a match 
is found. If the available DEF supply is 
exhausted, the next CSD is located. This 
is accomplished by adding the length of the 
first to the start address of the first, in 



order to address the second and so on until 
a match is found. When the match is found, 
the address of the CSD start location, the 
value of the matching DEF, and the page 
number in text of page of the CSECT con- 
taining this DEF, are returned in the pa- 
rameter list in words 2, 3, and 4 respec- 
tively. General register 15 will be set to 
zero signifying a normal completion. 

If no matching DEF can be found, and the 
supply of available CSDs is exhausted, gen- 
eral register 15 is set to X* 21* before a 
return is made to the caller. 

Page Conversion Routine (CEIFL) 

Chart AA, Page 12 

This is the routine called to convert an 
external page number to the actual cylin- 
der, head, and record (CCHHR) address of 
the record. On entry to the routine, gen- 
eral register contains either a X f 01 i 
(for disk conversion 2311) or a X'O**' (for 
disk conversion 2314). Parameter registers 
contain the page number to be converted and 
the address of the 6 4-word save area. 

The code type is determined, and control 
is sent to one of the following two 
routines: 

• For type 2311 disks, the page number is 
compared with the possible upper and 
lower bounds to determine its validity. 
If the page number is valid, the cylin- 
der is obtained by dividing the number 
by 8. The remainder is then used as an 
argument in the table look-up to deter- 
mine track and record number. The full 
address, including the binary number 
(which is zero in this case) , is con- 
structed in the return registers. The 
remaining registers are restored, gen- 
eral register 15 is zeroed and control 
is returned to the caller. 

• For type 2314 disks, the page number is 
also examined for validity. If valid, 
the page number is divided by 32, to 
determine the cylinder number. The 
remainder is divided by 4, to determine 
the relevant quarter cylinder required. 
This is then multiplied by 5, to obtain 
the initial track address of the rele- 
vant quarter. The second remainder is 
then used as the argument to determine 
track and record value within the 
quarter cylinder. The value is added 
to the initial track address to obtain 
the record address. Returning is 
accomplished as described above. 

If an invalid page number is sent as a 
parameter, an error code is set in register 
15 and control is sent to the calling rou- 
tine. No further processing takes place. 
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The error codes are X'Al* for 2311 disk 
error, X'A2' for 2314 disk error. 

Create List of Pages Routine (CEIFV) 

Chart AA, Page 11 

The purpose of this routine is to create 
a list of external pages for a data set f 
ordered by virtual page number. 

Prior to entry, general register is 
set with the path of the device on which 
the data set resides. Another parameter 
points to the location where the list is to 
be constructed. The format-E DSCB will 
already have been read, and will be in the 
beginning of the common I/O area. 

The count of total pages assigned to the 
given data set is taken from the format-E 
DSCB. A field is then primed with the 
maximum number of possible page entries 
that can be contained in the DSCB (38 for a 
format-E DSCB) . External page numbers are 
moved one at a time from the DSCB to the 
list area. Each time a page is stored, the 
count of possible entries and the count of 
total pages assigned are decremented by 
one. Processing continues until either 
count becomes zero. If the count of pos- 
sible entries in that DSCB becomes zero 
before the count of pages assigned, the 
chain field of the DSCB is checked and the 
continuation DSCB is read via CEIFS and 
moved to the beginning of the I/O area. 
The maximum count of entries field is 
primed to 62 for this format- F DSCB and 
processing continues. The list is complete 
when the count of total pages assigned 
becomes zero. 

If the continuation DSCB cannot be read, 
general register 15 is returned from CEIFS 
with a nonzero value and this code is 
passed back to the calling routine. Other- 
wise, a zero code is returned. 

Locate Descriptor in POD Routine (CEIFU) 

Chart AA g Page 13 

The purpose of this routine is to locate 
the member descriptor in the POD, either by 
name or by alias. 

Prior to entry to this routine, the 
entire POD will have been read into main 
storage contiguously. Word of the param- 
eter area contains the address of the POD 
and word 2 contains the member name address 
(8 bytes with trailing blanks). 

Using the Hash algorithm, as described 
under Startup (see Section 3), this routine 
hashes the member name. The hash value is 
used as an offset to the hash table to pick 
up the first link in the chain. If either 



a zero entry or a zero chain is encountered 
before the member descriptor is located, an 
error return is made with the code set to 
X f 22'. The chain of names with the same 
hash value is followed and each name is in 
turn compared with the given name until a 
match is found. If the match is made with 
an alias, the member descriptor pointer is 
followed to give the member descriptor. 
The relative page number of page of the 
member, and the number of bytes in the last 
page, are returned in word 1 of the parame- 
ter area. General register 15 is zeroed, 
and control is returned to the caller. 

Assign External Space Routine (CEIFW) 

Chart AA, Page 11 

The purpose of this routine is to assign 
pages of external space from a volume, and 
mark those pages as assigned in the corres- 
ponding PAT. Prior to entry, general 
register is loaded with the 13-bit device 
address of the disk from which space is to 
be assigned. General register 1 contains 
the address of a word that contains the 
number of pages reguested followed by a 
word list area in which to return the 
external page numbers assigned. (Since the 
number of pages requested can vary, the 
word list area varies in proportion with 
the number of pages requested. ) 

The device address is examined to deter- 
mine from which device the pages are to be 
allocated. The corresponding PAT for that 
device is selected and searched for pages 
marked available. (The byte in the PAT 
corresponding to an available page contains 
X'OO'.) For each page found, the external 
page number is entered in the list area and 
the byte in the PAT corresponding to that 
page is changed to X'Ol*, thus indicating 
that the page is now assigned. When the 
requested number of pages have been found, 
register 15 is zeroed and control is 
returned to the caller. If the PAT is 
exhausted before the requested number of 
pages have been found, register 15 is set 
to X'08" and control is returned to the 
caller. 

Communicate With Operator Routine (CEIFR) 

Chart AA, Page 15 

This routine serves two purposes. It 
either sends a message to the operator with 
a no-reply condition, or sends a message to 
the operator and waits for a reply. Since 
there are common message-write and message- 
read areas r it is the responsibility of the 
calling routine to set up the message-write 
area, and clear out any message reply that 
may already be there. On entry to this 
routine, the message area must contain the 
length of the message in the first word. 
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followed by the message itself. General 
register contains a 13 -bit terminal 
device address (right adjusted), and gener- 
al register 1 indicates whether a reply is 
expected (X'OO* = no reply expected, X* OH* 
= reply expected) . 



The routine relocates the addresses in 
the CCW list and the address of the PSW to 
be used when it is first entered. A switch 
is set to inhibit relocation on subsequent 
entries. The indicator in general register 
1 is used to set the command chaining flag 
in the first CCW (the write CCW) , when a 
reply is expected. The current new I/O PSW 
is stored, and the routine sets its own new 
I/O PSW. The CAW is set with the address 
of the CCW list, and a Start I/O issued. 
If the "busy* condition is present, the 
routine reissues Start I/O until the condi- 
tion is cleared. If the • CSW stored' con- 
dition is present, the routine goes to test 
whether the I/O is complete and successful. 
The 'not operational* condition causes the 
routine to set an error return code and 
return to the calling routine. When the 
•available" condition is present, the 
machine is forced into the WAIT state, with 
only the multiplexor channel enabled, until 
an I/O interruption is received. A TEST 
I/O is initiated and reissued if the 'busy" 
condition is present. Otherwise, the new 
I/O PSW is set to its entry condition, and 
the CSW status bits inspected. The pre- 
sence of any of the following conditions 
results in the error check being taken: 



program check 
protection check 
channel data check 
channel control check 
interface control check 
chaining check 



When the 'unit exception* occurs during 
the read, the CAW is set with the address 
of the second CCW in the list (the read 
CCW) , and the routine loops back to reissue 
the Start I/O. The presence of a unit 
check results in a sense command being 
issued to the terminal. If the check was 
caused by intervention being required, the 
alarm bell is rung, and the routine loops 
back to reissue the original Start I/O. In 
any other case an error action is taken. 

The routine loops and tests I/O until 
the operation is completed successfully, 
and the 'device end" condition is present. 



Disk I/O Routine (CEIFS) 



Chart AA, Page 15 



The purpose of this routine is to do 
disk I/O in one of the three following 
ways: 



to read a record, given its CCHHR 

to write a record to its CCHHR 

to read a record after a search on key, 
and provide CCHHR 

On entry to the routine, the length of 
the record in question must be in the first 
word of common disk I/O area. If the re- 
cord is to be written out, it must immedi- 
ately follow the length field. In the case 
of a read, the record will be read into 
this area. For the third option, the 44- 
character key must be moved into this area 
on entry; then when the record is located, 
the data portion is read to follow the key, 
and the record ID is read into a store area 
and subsequently moved to the input parame- 
ter area. General register contains the 
13-bit device address, right adjusted, and 
general register 1 has the address of a 
6-byte parameter area (aligned on a word 
boundary) f which contains the 5-byte record 
ID and a 1-byte code. This byte contains 
X^OO', X'0H\ or X'OS* for options 1, 2, 
and 3 respectively. If the option is 3, 
the record ID field contains the cylinder 
and track from which to begin searching. 

The routine now relocates the addresses 
in the CCW list and the address of the PSWs 
to be used when the routine is first 
entered. A switch is set to inhibit relo- 
cation on subsequent entries. On option 3, 
the CAW is set to the address of the CCW 
that searches for the record ID. Other- 
wise, the CAW is set to the address of the 
CCW list which searches for the record ID 
and reads or writes the located record. 

A Start I/O is then issued and the con- 
dition code inspected. If the device is 
busy, the routine loops on Start I/O until 
the device is free. On condition code 1, 
the routine goes to test the CSW. On con- 
dition code 3, general register 15 is set 
to X'43" and control goes to the caller. 
Once successful, the routine goes into the 
WAIT state until an I/O interruption is 
received. TEST I/O is issued and the con- 
dition code examined. If the condition 
code is 2, the routine loops on the TEST 
I/O, otherwise the CSW is inspected. If 
the 'device end' is not on, the routine 
branches to TEST I/O until the device is 
free. If any of the following occur, an 
error action is taken, and the error code 
set to X'^O' : 

program check 
protection check 
channel data check 
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interface control check 
chaining check 

The routine attempts the I/O operation 10 
tiroes before declaring a hardware error on 
the following conditions and setting the 
corresponding error codes: 

record not found X'40" 

read error X'^l* 

write error X'48' 

nonoperational X f 43' 

Otherwise, a normal return is executed. 

Find Format- E DSCB Routine (CEIFDS) 

Chart AA, Page 16 

The purpose of this subroutine is to lo- 
cate and read a format-E DSCB or to return 
the location of an available DSCB to the 
calling routine. If the name of the data 
set to be located consists of all zeros, 
the location of an available DSCB is 
returned . 

On entry, general register contains 
the 13-bit device address of the device to 
be searched, and general register 1 con- 
tains the address of a 12- or (optionally) 
13-word parameter list. The parameter list 
consists of one word in which to return the 
address of the DSCB that is found, followed 
by a 44-character data set name. The last 
word, the optional one, is sent only if the 
calling routine wishes to have returned the 
relative page number on which the DSCB was 
found. (If this parameter is reguested, 
the SBDDS1SW field in the SYSBLD table has 
been set to X'FF' prior to entry.) 

The device to be searched is determined 
by comparing its address with those of the 
IPL and ACV volumes as stored in the SYSBLD 
table, and the corresponding PAT table is 
selected. The PAT for that device is 
scanned for pages marked as DSCB pages. 

If CEIFDS is searching for an empty 
DSCB, it tests bits six and seven of the 
PAT entries. Bits six and seven must be 
zero, indicating available space or the 
page is skipped. Once an available page is 
found, Convert Pages (CEIFL) is called to 
convert the external page number to a 
CCHHR. The Disk I/O routine (CEIFS) is 
called to read the page into the common I/O 
area. The sixteen DSCB slots per page are 
examined. If CEIFDS is looking for a non- 
zero data set name, the da-ta set type field 
of the DSCB must contain X'Ol* to indicate 
format-E DSCB and the data set names must 
match. If looking for an available DSCB, 
the data set type must be X'00 f . If an 
available DSCB is found on an already 
existing DSCB page, a check is made to see 
if it occupies the twelfth slot. If so. 



the sixth bit of the corresponding PAT 
entry is set to indicate that no new 
format-E DSCB should be allocated from this 
page. If no empty DSCB can be allocated 
from the existing DSCB pages, an available 
page is found and the PAT is modified to 
indicate that this is a new DSCB page. The 
page is zeroed and the first slot is 
selected for the requested DSCB. 

When the DSCB is found, the address of 
the DSCB is set in the parameter list. The 
SBDDS1SW is checked and the external page 
number parameter is set if requested. 

If any subroutine called returns an 
error code, CEIFDS passes this code back to 
its calling routine. If an available page 
cannot be allocated as a new DSCB page, and 
error code of X'41' is returned to the cal- 
ling routine in general register 15. 

Checksum (CEIFCKS) 



Chart AA, Page 13 

This routine develops a check sum for a 
DSCB. On entry, general register 10 con- 
tains the address of the DSCB. General 
register contains a if this routine is 
to verify an existing check sum or a 1 if a 
new check sum is to be developed. For the 
first option, a return code of zero is 
returned to the caller if the check sum 
agrees, or X'O**' is returned if it does not 
agree. Control is returned to the caller. 

Update Catalog SBLOCK Routine (CEIFECAT) 

Chart AA, Page 14 

This routine finds and stores the DSCB 
address for a data set in the Catalog 
SBLOCK. After chaining backward through 
the Catalog SBLOCK to determine the fully 
qualified name for the data set, CEIFECAT 
calls CEIFDS fo find the DSCB address. The 
DSCB address is in the form SOOOPPPP, where 
S is the slot number, OOO is the relative 
volume for the ACV, and PPPP is the rela- 
tive page number on which the DSCB is 
located. If the DSCB address is found, it 
is stored in the CCCDPT field in the Cata- 
log SBLOCK and control is returned to the 
caller. If the DSCB address is not found, 
control is passed to the Terminating 
routine. 

Update Device Tables for RSS and VSS 
(CEIFRS1, CEIFRS2) 

Chart AA, Page 16 

In order to find the CSECT containing 
the device table CHBECXRB utilized by RSS, 
the Update Device tables routine modifies 
the Update Pathfinder tables routine 
(CEIFD) . The Update Pathfinder tables rou- 
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tine is modified to search the TSS*****. 
RSSSUP data set for the CSECT containing 
the table CHBECXRB. (The Update Pathfinder 
Tables routine initially searches TSS*****. 
RESSUP for its device tables and initia- 
lizes them,) 



Once the CSECT containing the table has 
been found, two fields are initialized to 
reflect the following information for each 
device type: 



• hardware device address 



• device defining information 



Each entry in CHBECXRB consists of three 
words that contain the following 
information : 

• symbolic device address 1 halfword 

• physical path (hardware 1 halfword 
address) 



• alternate physical path 1 halfword 

• flag byte 1 byte 

• reserve byte (unused) 1 byte 

• device defining codes 1 word 

After initializing the table, the page 
containing the CSECT in which the table 
resides is written back onto the IPL 
volume • 

Next, the Update Pathfinder Tables rou- 
tine is modified to search the TSS*****. 
SYSIVM data set for the CSECT containing 
the table CHBECXVA. CHBECXVA contains 
device information utilized by VSS (nonre- 
sident portion of TSSS). The body of this 
table is a duplicate of CHBECXRB and is 
initialized to reflect the same informa- 
tion. Once initialized, the page contain- 
ing the CSECT in which this table resides 
is rewritten onto the IPL volume. 
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SECTION 3: STARTUP PHASE 



STARTUP PRELUDE (CEIAP) 

This program performs certain environ- 
mental analyses, stores the results in a 
communication region, loads the Startup 
module and transfers control to it. Refer 
to Section 1 for a preliminary discussion 
of this module (see also Chart AB) • 

Attributes ; This module is nonrelocatable 
and resides in real storage. 

Entries : Prelude is entered by a hardware 
IPL or a system restart. In the event of a 
hardware malfunction. Reconfiguration 
CCGCMA) is invoked to set up a damage 
report. When finished processing. Recon- 
figuration simulates a hardware IPL and 
calls Prelude. 

Exits : Normal exit is made by loading 
Startup , and sending control there. Errors 
that cause termination force the machine 
into the WAIT state and set the instruction 

address counter to all 1's. 

Operation : Prelude is entered through a 
hardware IPL or a system restart. Base 
registers are set, and the communication 
region zeroed out (Figure 3). The extended 
control registers and the address of the 
IPL volume are saved. If it is a system 
restart, the Reconfiguration program will 
have filled a fixed hardware location 
called C0MAR with the characters "RESTART". 
Prelude need only compare this cell with 
its own constant "RESTART" to determine how 
it has been entered. The address of the 
operator's terminal is also passed to Pre- 
lude by Reconfiguration (it will be moved 
to the communication region at entry) . The 
volume label of the IPL volume is read, 
extended mode entered, and the system put 
into the WAIT state, in anticipation of an 
I/O interruption. Once the interruption is 
encountered, the interruption code area 
contains the 13-bit (extended mode) address 
of the IPL volume. This is moved into the 
communication region. 

If Prelude has been entered via IPL, it 
enters the WAIT state and waits for an 
asynchronous interruption from the opera- 
tor* s terminal. Once the interruption 
occurs, the address of operator's terminal 
is in the interruption code area and can be 
moved into the communication region. Pre- 
lude then moves the volume serial number 
and the address of the IPL volume PAT from 
the label to the communication region. 

Prelude now searches for locations into 
which it can read the Configuration Control 



Block (CCB), PAT and DSCB pages. These 
locations must be determined dynamically 
for two reasons. First, the prefix storage 
areas (PSAs) of a multi-CPU system are 
double addressable, and provision is made 
that the locations do not overlay Prelude. 
Second, since it is not necessary for the 
floating storage addresses (FSAs) of the 
storage elements (SEs) in the system to be 
assigned contiguously in main storage, not 
every address may be valid within any par- 
ticular installation at any given time. 
Prelude searches for the lowest available 
main storage locations for these buffers. 
Their addresses are placed in the communi- 
cation region. 



The PAT is read in as soon as its buffer 
location is returned. Prelude then 
searches the DSCB pages on the IPL volume 
(using the PAT) for the DSCBs for Startup, 
the CCB, and Quickstart. If only the 
Quickstart DSCB if found, a message 
(QKSTART IN PROGRESS) is issued and proces- 
sing continues. If the Startup and SYSCCB 
DSCBs are found, but not the Quickstart 
DSCB, the STARTUP IN PROGRESS message is 
issued. If both the Startup and Quickstart 
DSCBs are found, a message (STARTUP? Y OR 
N) is issued to the operator. Y requests a 
normal Startup; N requests a Quickstart. 
If a normal Startup is wanted, SYSCCB must 
be present. If the correct DSCBs are not 
found, a message is issued and Prelude 
terminates. 

In a normal Startup, the entire data 
sets TSS*****. STARTUP. G0OOOV0O and 
TSS*****. SYSCCB. G0000V00 are read. In a 
Quickstart, the first page of TSS*****. 
QKSTART . DSxxxxxx is read to get the length 
of Startup and the CCB. The Startup and 
SYSCCB data sets are read sequentially from 
the Quickstart data set, beginning with the 
third external page entry of the data set. 

Simplex is the term used to describe a 
system consisting of a model 1 CPU; there 
is no prefixing ability and never more than 
one CPU in the system. Duplex is the term 
describing a system of model 2 CPUs. All 
model 2 CPUs have prefixing ability. A 
time-sharing system with only one model 2 
CPU is referred to as half- duplex. This 
CPU has prefixing abilities and roust not be 
confused with simplex. 

The next task is to determine the iden- 
tity of the initially-loaded CPU. In a 
duplex or half-duplex system, the CPU's ID 
is moved into the first byte of each PSA 
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F3C 
F44 

F4C 
F68 
F70 
F74 
F78 
F7C 
F80 
F84 
F88 
F8C 
F90 
F94 
F98 
F9C 
FAO 
FA4 



COMAR — Startup or Restart Indicator 



DAMREP 



Damage Report From Reconfiguration (Restart Only) 



CREGS -— Contents of Extended Control Registers 8-14 



SESIDS — Byte Map for Storage Elements (SEs) 
SESTSS — Number of SEs in TSS 



I 



CPUSTSS — Number of CPUs in TSS 



OTHCPU — IDs of Non-IPL CPUs 



|SCPID — ID IPL CPU 

-JL „. . 



CCUTSS — Byte Map CCUs in TSS 



PARTND — Byte Map Partitioned CCUs 



CCBLEN — CCB Length Cin pages) 



STPL -- Length of Startup Module 



TERMAD — Address of Operator Terminal | Unused 



VOLTPC — Volume Type Code 



VOLAD — IPL Volume Address 



PRINTER -- Printer Address* 



| IPLID 
-JL„. — .„_- 



Volume Serial 



Volume Serial (Continued) 



H — 



DSCBLOC -- DSCB Buffer 



PATLOC -- PAT Buffer 

LOADPT — Starting Address for Startup 



F— 



CCBLOC — CCB Load Point 



IPLPFX — Active Prefix of IPL CPU 



h 



♦Initialized by Startup. 



Figure 3. Communication Region ■ — Prelude to Startup 



associated with that CPU, This process is 
repeated for each CPU within the system* 

Addressable location now contains the 
desired information if and only if one of 
the PSAs has been activated. Location is 
checked and f if a valid ID is found, it is 
moved to the communication region and 
becomes the ID of the CPU in question. If 
no valid ID is found, no PSA has been acti- 
vated, and the error message to activate 
the prefix and re- IPL is issued at the 
operator 1 s terminal. Prelude then 
terminates. 

In a simplex system, only one CPU 
exists . Since there is no prefixing, all 
SEs are assumed to be in the time- sharing 
system, and control passes to Build a Table 
of PSAs. 

In a duplex or half-duplex system, it is 
possible that not all of the devices are 
attached to the time-sharing system. In 
this case a configuration analysis is made. 
The configuration is composed of all SEs, 



channel control units (CCUs) and CPUs in 
the system. SEs in the system must be con- 
nected to the loaded CPU. A CCU must be 
connected to the initially loaded CPU and 
all the SEs in the system. A CCU must also 
be disconnected from those SEs and CPUs not 
in the system. Other CPUs must have the 
same SE/CCU hookup as the initially-loaded 
CPU. Configuration information is set in 
the communication regions the number of 
SEs in TSS, byte maps for these SEs and the 
CCUs in the system, and a byte map for 
those CCUs not in the system. Due to the 
three-fold requirements of the CCUs, an 
erroneous setting of the configuration con- 
sole switches could project the false 
impression that no CCUs exist in the sys- 
tem. In this case a message is issued 
instructing the operator to correct the 
switches and Prelude terminates. 

Prelude next analyzes the prefix activa- 
tion and the direct control switch settings 
on the configuration console. For systems 
with two or more CPUs, these switches must 
be activated for all CPUs in the system. 
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For a half-duplex system, prefixing must be 
activated, and direct control must be 
deactivated. 



Prelude now checks that there are no 
duplicate FSAs in the syst€an, since the 
physical addresses are variable. Should a 
duplicate exist, a message is issued to the 
operator to correct the configuration con- 
sole dials and Prelude terminates. Other- 
wise, processing continues. 



Because PSA areas should not be over- 
laid, a table of PSAs is built for all CPUs 
in the system. 



Now a storage analysis creates a page 
map giving the condition of every page in 
main storage: available to the system, 
partitioned from the system, or failing. 
Partitioned pages are those; not addressable 
by the system; that is, no FSA gives that 
address. "Failing" means ci machine check 
interruption was detected while the page 
was being used. While the page map is 
being created, the load point for Startup 
must be determined. It has to be loaded 
contiguously into the high€jst available 
pages without overlaying any PSA. This 
load point is now moved into the communica- 
tion region. If no load point can be 
found, a message is issued at the terminal 
and Prelude terminates. 



STARTUP (CEIAA) 

Startup (Chart AC) is the module that 
performs the operations necessary for 
initialization of the time-sharing system. 
If a hardware failure occurs, any subse- 
quent execution of Startup constitutes a 
system restart. The Startup module is non- 
relocatable, operates in the supervisor 
state, and resides in real storage. It is 
a single module containing many subrou- 
tines, all running under control of a main- 
line. In order to run. Startup needs the 
basic minimum machine requirements (see the 
System Generation and Maintenance SRL) . 
The program assumes SYSBLD has created the 
configuration-dependent tables to be used 
or initialized by Startup. All public 
volumes must be mounted, and the System 
Catalog data sets (SYSCAT and SYSSVCT) 
should be on the ACV volume (public volume 
0) . Storage need not be contiguous nor 
start at location 0, but the starting 
address of the highest storage box must be 
dialed to not exceed 256 ,000 (n-1) , where n 
is the number of boxes present at the 
installation. 

Startup has two primary functions. The 
first is the CSECT link-loading of the Ini- 
tial Virtual storage (SYSIVM) f Resident 
Supervisor (RESSUP)and Resident Support 
System (RSSSUP) data sets. The second is 
the creation and initialization of various 
tables . 



Next the f Resident Supervisor" flag is 
set in the byte of the page map that corre- 
sponds to the active PSA. In simplex mode, 
the PSA is in page and the page map is 
set to reflect this. In duplex or half- 
duplex mode, the address of the PSA is 
determined dynamically. The addresses of 
the primary and alternate PSAs are stored 
in the first fullword of the primary and 
alternate PSAs, respectively. Locations 
0-3 then contain the address of the PSA 
that is active. This address is moved into 
the communication region and the byte in 
the page map is set to reflect this. If 
the active PSA had previously been detected 
as failing, a message is issued and Prelude 
terminates. 

Finally, Prelude reads Startup into the 
location determined during the storage ana- 
lysis, and the program exits to that 
location. 

Prelude also includes a few short ser- 
vice routines used to perform the work that 
is usually done by the system but is not 
yet available. Routines are set up to: 
recover from program or machine check 
interruptions; convert external page num- 
bers to CCHHR form; do I/O initialization; 
and communicate with the operator. 



RTAM INITIALIZATION 

RTAM Initialization provides initial 
values for the tables required by RTAM to 
log the main operator onto the system. The 
LOGON processors require such information 
from the main operator as his user identi- 
fication, terminal address, and terminal 
type; since the operator cannot log himself 
onto the system. Startup must furnish the 
information. There are four steps in RTAM 
Init ializat ion : 

1. Calculation of the number of Task Core 
Table pages (CHBTCT) and the number of 
system buffer pages (CHBBFP); these 
depend on the number of terminals con- 
nected to the system during system 
generation. 

2. Storage allocation (virtual and real 
storage) for the Task Core Storage 
Table pages and system buffer pages. 

3. Page table initialization (Shared Page 
Table and External Shared Page Table) . 

4. Initialization of certain other 
tables . 
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The tables modified, initialized, or 
created for RTAM are CHBTCT, CHBBFP, 
CHBMTS, CHBDEV, and CHBTDE. 

The storage requirements for CHBTCT, 
CHBBFP, and CHBMTS are: 

1. The virtual storage address of the 
Task Core table must start at the 
first page of the first public segment 
of IVM. 

2. The first page of the Task Core table 
and the first page of system buffer 
pages must reside in real storage at 
all times. This is ensured by turning 
on the "page hold" flag in the XSPT 
entries reflecting the virtual storage 
addresses assigned to them, 

3. CHBMTS must begin on a 64-byte 
boundary. 



The RESSUP and RSSSUP delta data sets 
and CSECTs are loaded in a similar manner 
to the SYSIVM CSECTs. However the follow- 
ing location differences exist for the 
RESSUP CSECTs: 

• RESSUP CSECTs except for SERR/ 
Reconfiguration reside in real storage. 
SERR/Reconfiguration CSECTs reside on 
all drums in the system. 

• The TDY, used only in the loading pro- 
cess, is not written on the paging 
volume. 

• User modules cannot be loaded into real 
storage. 

If a Quickstart is in progress, the 
link- edited routines are read from the 
Quickstart data set. 



LINK- LOADING 

During link- loading, each data set con- 
tains a CSECT load list module which con- 
tains the names of the CSECTs to be link- 
loaded. The delta data sets are sorted 
into three groups, those for IVM, for 
RESSUP, and for RSSSUP. Within these 
groups, the order in which the delta data 
sets were entered is maintained. The delta 
data sets for IVM are processed first and 
then SYSIVM is processed. After the load 
list is read in, the PMDs for CSECTs in the 
load list are linked into the Task Dic- 
tionary table (TDY) . If user modules are 
being loaded, all additional user CSECT 
names (those not present in the load list) 
are added at this time. After a PMD is 
moved into the TDY, the definitions within 
each of the PMDs CSECTs are resolved. 
(Preceding the PMDs in the TDY are a head- 
er, system hash table, user hash table and 
storage map. ) Private CSECTs are loaded 
into segment of virtual storage, while 
the public CSECTs are loaded into segment 
1. The Interruption Storage area (ISA) is 
automatically assigned a virtual storage 
address of zero. After all PMDs are linked 
into the TDY, the TDY storage map is 
created. It is made up of two-word entries 
for each CSECT in the TDY. The first word 
is the virtual address for the CSECT. The 
second is the address of the CSECT' s CSD. 
The entries are in a numerically ascending 
sequence of virtual storage addresses. The 
CSECTs are read in a page at a time, and 
packed into the output buffer. They are 
then written on the paging drum if they are 
public CSECTs, or written on the paging 
disk if they are private CSECTs. Once pro- 
cessing is complete, then both the TDY and 
the Shared Data Set table (SDST) are writ- 
ten on their respective paging volumes. 



INITIALIZATION OF TABLES 

Tables are created, initialized, or 
modified as follows: 

For SYSIVM, 

• Task Dictionary table (TDY) 

• Interruption Storage Area (ISA) 

• Buffer Page (BFP) 

• Skeletal Extended Task Status Index 
(XTSI) 

• Terminal Control Table (TCT) 

• Symbolic Devxce Allocation table (SDAT) 

• Task Data Definition table (TDT) 

• Shared Data Set table (SDST) 

• Public Volume table (PVT) 
For RESSUP, 

• Prefix Storage Area (PSA) 

• CPU Status table (CST) 

• Special Device Path tables 

• Auxiliary Storage Allocation table 
(ASAT) 

• Resident Shared Page Index table (RSPI) 

• Core Block table (CBT) 

• Shared Page table/External Shared Page 
table (SPT/XSPT) 
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• System -table 

• System Activity and Resources table 
CSAR) 

• Multi-terminal Status Control Block 
CMTS) 

• Device Group table CDEV) 

• Terminal Device table (TDE) 
For RSSSUP, 

• Communication table (RSSCOM) 

• Page table/ External Page table (PTO- 
PT3, XPT2-XPT4) 

• RSS Symbol table (CHBRST) 

• Support System Device Allocation table 
(SSDAT) 

Once this is complete, Startup creates a 
task (TSI) for the Main Operator's Task 
(MOT) . Startup interrogates the 2702 par- 
titioning lines and enables those lines 



INPUT 

SYSCCB 
SYSIVM 
R ESS UP 
RSSSUP "* 




IPL Volume 




Delta 
Volume 




Card 
Reader 



DELTA DATA SETS 



Delta Volume Address . 

Delta Data Set Names 

(Storage element names and FSA's) 

Paging disk address 



Delta Volume Address 

Delta Data Set Names 

(Storage element names and FSA s) 

Paging disk address 



which are not partitioned out of the confi- 
guration- In addition, the malfunction 
alert fields in control register 6 are 
enabled for duplex and masked for half- 
duplex operations. 



INPUT TO STARTUP 

The four major sources of input to 
Startup (Figure 4) are: 

• The IPL volume 

• The Delta volume 

• The Operator's 1050 terminal 

• The Card Reader 

The SYSCCB, SYSIVM, RESSUP (VPAM for- 
matted) and RSSSUP data sets reside on the 
IPL volume. 

The delta volume contains data sets that 
may modify the SYSIVM, RESSUP, and RSSSUP 
data sets which reside on the IPL volume. 
This provides the optional capability for 



OUTPUT 



k Fully Initialized Tables 

and 
'Operable Time Sharing System 



Figure 4. Startup Input and Output 
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dynamic modification of the time-sharing 
system at Startup time. 

Information from the operator's terminal 
or card reader includes: 

• The address of the delta volume and the 
names of the delta data sets, if any. 

• The names of the storage elements and 
their corresponding FSAs for simplex 
CPUs. 

• The address of the paging disk. 

• The address of the Quickstart volume. 

• Load list codes of functions not to be 
loaded. 



OUTPUT FROM STARTUP 

The output created by Startup results in 
a fully initialized and operable time- 
sharing system. However, there are several 
error conditions that will cause the ter- 
mination of the Startup process. Startup 
terminates if: 

• There are too many malfunctioning pages 
in main storage, thus preventing the 
allocation of buffer space for Startup. 

• The SYSIVM, RESSUP or RSSSUP data sets 
are not on the IPL volume or have 
incomplete or missing PODs. 

• The space allocated for the Extent 
table. Read table or storage map is too 
small. 

• The system catalog data set cannot be 
located. 

• Certain critical CSECTs are not present 
in the Delta or system data sets or 
their respective load lists. 

• There is I/O malfunctioning while the 
IPL volume or the paging volume is 
being accessed during the initializa- 
tion of the SDAT. 

• The interval timer has not been enabled 
or is malfunctioning. 

• The operator's terminal is not repre- 
sented in the system pathfinding table. 

• The initial virtual storage requires 
more than 16 segments. 

• The operator cancels Startup by reply- 
ing 'N f when asked CONTINUE Y or N 



after Startup discovers errors with 
delta data sets. 

In any of these cases the operator is 
notified of the cause of termination at his 
terminal. If there is I/O malfunctioning 
during an attempt to use the operator's 
terminal, a message is issued on the 
printer. 



STARTUP INTERFACE 

Using normal linkage conventions. Start- 
up communicates with the following external 
routines which are called to complete 
Startup processing: 

• Inter-CPU Communication (CEIACO issues 
external starts to the non-IPL CPUs. 

• Set Path (CEAA5S) partitions paths to 
the I/O devices. 

• Pathfinding (CEAA5P) locates paths to 
the I/O devices. 

• Reverse Pathfinding (CEAA5R) returns a 
path to the system and determines its 
symbolic device address, 

• Supervisor Core Allocation (CEAL1A) 
allocates main storage. 

• Task Initiation (CEAMT1) creates and 
activates a TSI for MOT. 

• Queue GQE on TSI (CEAAFQ) queues a GQE 
(containing a simulated asynchronous 
interruption) on the TSI for MOT. 

At the conclusion of Startup, the 
initially- loaded CPU exits to the Queue 
Scanner and the other CPUs exit to the 
Dispatcher. 



INTERNAL TABLES 

Startup creates and uses internal 
tables, buffers and work areas (Figure 5), 
as follows: 

AUXILIARY STORAGE DEVICE LIST buffer - set 
up by the SDAT initializer. This contains 
the symbolic device address, the device 
type code, and the extents for all unavail- 
able pages on auxiliary devices. This list 
is used by the Auxiliary Storage Allocation 
routine to create directories for disk and 
drum in the Auxiliary Storage Allocation 
table. 
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CONFIGURATION CONTROL BLOCK buffer - a data 
set read in by Prelude. This is the table 
set up by SYSGEN (and modified by SYSGEN) . 
It contains configuration-dependent infor- 
mation utilized by Startup. It supplies: 
the path of the drum to be used as the pag- 
ing drum; the address of an alternate 
printer should the current one malfunction; 
and the number of Shared Data Set table 
pages. It also contains information used 
to update the CPU Status table (CST> and 
the Pathfinding tables. 



EXTENT table - a multipurpose area. This 
table contains the extents for the SYSIVM, 
RESSUP and RSSSUP data sets., During 
initialization of the Pathfinding tables , 
it contains a list of partitionable control 
units. The routine to initialize the SDAT 
uses the Extent table as a drop area to 
contain the symbolic device addresses, and 
virtual storage pointers to the SDAT 
entries for all volumes containing the Sys- 
tem Catalog. It is also used when the JFCB 
for the System Catalog is updated. 



INPUT buffer - information from the IPL 
volume is read into this buffer, as are the 
three data sets used during link- loading. 
While the SDAT is being initialized, the 
first 144 bytes of the buffer are used as a 
read-in area for the format- 4 DSCB con- 
tained on the disks. The area following 
these bytes is used to contain the Auxi- 
liary Storage Device List. 



LOAD LIST buffer - contains the load list 
for the SYSIVM, RESSUP, or RSSSUP data 
sets. 



STORAGE BYTE MAP - used to determine the 
availability of pages in main storage. It 
supplies information for initialization of 
the Core Block table and setting of the 
storage protection keys. 

OLD POD buffer - used by the link loader to 
hold the POD for either the SYSIVM, RESSUP 
or RSSSUP data set, whichever is being 
processed. 
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OUTPUT buffer - the buffer from which data 
is written on the primary paging volume, 

DRUM LIST table - used during the link 
loading phase to contain the hardware 
addresses of the drums in the system, the 
first drum being the paging drum. The list 
is used to locate the paging drum and then 
provide addresses for all the drums, so the 
SERR/Reconf iguration modules may be written 
on them. The hardware addresses are con- 
verted to symbolic device addresses, and 
this list is used by the Auxiliary Storage 
Allocation routine to insert the drum 
addresses into their respective drum direc- 
tories in the ASAT. 

PSA buffer - used as a temporary storage 
area to hold the PSA CSECTs. The PSA 
CSECTs are moved to PSABUF after they are 
read in during RESSUP processing. After 
the PSA is initialized, and just before 
exiting from Startup, the PSA is moved to 
the actual PSA area. 

RESSUP/RSSSUP SYMBOL table - contains the 
symbol and address of every entry point in 
the Resident Supervisor and the Resident 
Support System. 

SDAT buffer - used during initialization of 
the SSDAT. 

SHARED PAGE TABLE buffer - used during 
initialization of the Shared Page table. 

TDY PAGE table - contains main storage 
addresses of the TDY for SYSIVM. This is a 
table of one or more three-word groups or 
extents. The first two words contain the 
lowest and highest real storage addresses 
relocatable by a common factor, namely, the 
third word. The end of the table is a 
double word of ones. 

WORK AREA - used as a DSCB and volume label 
read- in area. All DSCBs for SYSIVM, RESSUP 
and RSSSUP data sets are read in here. 

WORK buffer - used to create the Free Space 
table and during SDAT processing. 

XTSI buffer - used during initialization of 
the XTSI. 

The following is a description of the 
logic flow of each of the Startup routines 
and subroutines. 



STARTUP MAINLINE (CEIAA) 

Startup (Chart AC) consists of a main- 
line routine which calls a number of inde- 
pendent routines with specific functions, 
and a set of common subroutines. Upon 
entry, the mainline executes several house- 
keeping steps, and sets up the base regis- 



ters. It also sets up a communication area 
within Startup, and moves into it the drop 
area set up and created by Prelude. A 
check is then made to see whether the 
interval timer has been activated. If it 
has not, a message 'Activate TIMER and Re- 
IPL f is issued and Startup terminates. 
Otherwise, the Enable routine is called. 

The Enable subroutine enables the 2702 
and 2703 lines so that a terminal user can 
dial into the time- sharing system. On 
entry, it does housekeeping, relocates CCWs 
and adcons according to Startup's load 
point, and obtains the addresses of the 
lines from the Transmission Control Path 
table (CCBTPT) of the CCB. The line's type 
and address are obtained from each entry in 
the table. The Enable subroutine deter- 
mines the SAD order specified, and the 
device class (dedicated versus dial-in) . 
An appropriate CCW list is constructed. 
The address of the list is set in the CAW 
and a SIO instruction issued. The complete 
CCW chain is not executed until someone 
dials into the line, ending the Enable com- 
mand that is command- chained to the rest of 
the list. A message is sent out on any 
line dialed- in. 

On return, the addressing capability of 
the system (24- versus 32-bit addressing) 
is determined. In order to do this, the 
system mask in the extended PSW is set to 
X f 08 f indicating that the 32-bit addressing 
feature is operating. If the 32-bit 
optional hardware feature has not been 
installed, a program interruption occurs 
when the next sequential instruction is 
reached. A switch (MCHSZE) is set accord- 
ing to the presence or absence of the 32- 
bit addressing feature. This switch is 
tested at various subsequent points to 
enable the system to operate in the proper 
mode. 

In a multi-CPU environment, control next 
passes to a mainline routine, P400X. In 
simplex mode this routine is bypassed. The 
purpose is to create a PSA list containing 
the addresses of the active PSA of each CPU 
in the system, excluding the loaded CPU. 
P400X does this by finding the address of 
the primary PSA of the CPU in the CCB. The 
routine then inspects the Page Map for a 
X^C 1 to determine if that page is avail- 
able as a user page. If so, the Page Map 
indicator is reset to X"94' indicating that 
this page is partitioned. The address of 
the primary PSA is moved into the active 
PSA list. Should this primary page be 
unavailable, the address of the alternate 
PSA of the CPU is found. If this alternate 
page is available, the partitioned flag is 
set in the page map and the address is 
moved into the active PSA list. If this 
alternate page is unavailable, the non- 
loaded CPU cannot be started up, since it 
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has no active PSA. In this case, the 
address placed in the active PSA list is 0. 
This list, set up by P400X, is used later 
by Startup to set up the CPU Status table 
(CST) , and the Storage Byte Map is used to 
allocate available pages, and set up the 
Core Block table CCBT) . 

The operator is asked for the address of 
the card reader in the event that operator 
response messages are to be bypassed. If a 
Quickstart is taking place, this question 
is bypassed and all queries are made to the 
operator's console. 

A test is made to determine whether this 
is a simplex system or not. If it is, the 
SIMFSA routine is called. If not, control 
passes to P100X. SIMFSA is the routine to 
request information regarding the FSAs on 
the SEs attached to a simplex CPU. The 
operator may partition out a storage ele- 
ment (block of 256K bytes) by not mention- 
ing that storage element's identification. 
However, the operator may not partition out 
the FSA that contains the PSA, or the FSA 
that contains Startup (just loaded), or 
Startup's buffers. If operator response 
messages are not bypassed, OPER is called 
with the message code asking the operator 
to enter the FSA code for each SE in TSS in 
this format: 



XN,XN,XN, 
where 



X = SE ID (A, B,C, ) 

N = FSA code (0,1,2, for 0-256K, 

256K-512K, 512K-768K. . . . . ) 

If operator response messages are bypassed, 
the READCARD routine is called to read a 
card containing this inf ormation. The 
operands are then accessed via GETFLD. All 
are checked for validity. An incorrect 
response condition is recognized if any of 
these conditions exist: 

• Operands are longer than two characters 
in length. 

• The number of responses exceeds the 
number of SEs at the installation. 

• An SE ID is not within the allowable 
range, which is the count of SEs at the 
installation. (If four SEs exist, the 
allowable range is A to D.) 

• An FSA code is not within the allowable 
range which is the numeric count of SEs 
at the installation, beginning with 0. 
(If four SEs exist, the allowable range 
is to 3.) 

• Two operands in the reply mention the 
same SE. 



• Any FSA code not mentioned that con- 
tains the PSA, Startup, or Startup's 
buffers. 

On any incorrect response condition, the 
operator is informed and asked to reenter 
the information. Should the same FSA code 
be assigned to two SEs, the operator is 
informed. If this is due to an incorrect 
response, he can then reenter the informa- 
tion correctly. If two or more SEs are 
actually set to the same FSA, the condition 
must be corrected and the system rein- 
itiated by an IPL. 

Once a completely valid response is 
received, the information is rearranged in 
extended control register 10 format and 
placed in the Startup communication region. 
This is later moved to the SE Status table 
in the PSA. Control comes back to the 
mainline routine P100X. The purpose of 
this routine is to move the Configuration 
Control Block, the Storage Byte Map, the 
IPL PAT page and an IPL DSCB page from 
their locations assigned by the Prelude 
routine to the buffers allocated them in 
Startup. (Information as to their origin, 
length, and destination is available to 
P100X in Startup's communication region.) 
The information is then moved in blocks of 
256 bytes until the entire block has been 
transported. The origin of the Page Map is 
at a fixed location, 190 16 . The destina- 
tion was allocated by GETMEM. The length 
of the map is proportional to the number of 
SEs in the particular installation. There 
are 64 bytes per SE. Once the move is com- 
plete, control continues on to the DMLST 
routine. 

Create List of Available Drums (DMLST) 
is another subroutine of the mainline. Its 
purpose is to identify all available drums 
of the system, and ask the operator to 
supply the address and device type code of 
an auxiliary device to be used as the pag- 
ing device. First, the routine searches 
each drum entry in the Drum Path table of 
the CCB for one available path to each 
drum. All entries are checked one drum at 
a time. If a good path is found, it is 
stored in a list. If no path is found, the 
next entry is checked until all are inves- 
tigated. The device attached to the first 
path in the list is used as the paging 
drum. A count of available drums is made, 
and the results are saved for the ASATRT 
routine. If operator response messages are 
not bypassed, a message is issued (via 
OPER) requesting the operator to supply the 
address of a paging disk. If operator 
response messages are bypassed, READCARD is 
called to read a card which contains the 
address of the paging disk. A check is 
made to see that the IPL volume address is 
not specified as the paging disk. If it 
is, the operator is prompted for another 
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address, A check is also made to see 
whether the paging pack is VAM2 -formatted. 
If not, the operator is prompted for an- 
other address. If so, and if a paging 
volume is mounted (byte 17 of the volume 
label = X'40') f processing continues. If c 
paging drive is not mounted, the operator 
is prompted for another address. The pag- 
ing disk is used as an additional paging 
device. If there are no drums available, 
all Startup paging is done on this paging 
disk. 



Subroutine RTMPGS is invoked next. It 
calculates the size of CHBTCT and CHBBFP 
(RTAM tables) . The sizes of these CSECTs 
depend upon the number of terminals con- 
nected to the system during system genera- 
tion. The results are saved in the com- 
munication region for use after link- 
loading. 



The Link loader. Startup's main proces- 
sing routine, is next invoked to load SYS- 
IVM. (A complete description of the Link 
loader is provided later in this section.) 

After SYSIVM has been loaded, a switch 
(PGWRT) is set and the link loader is 
recalled. The switch setting indicates 
that RESSUP/RSSSUP is to be loaded. If a 
Quickstart is taking place, the link-loader 
is bypassed and QKREAD is called to read in 
the link-edited version of IVM, RESSUP, and 
RSSSUP. 

If Delta data sets were specified, a 
message is now issued at the operator 1 s 
terminal. This message notifies the opera- 
tor that he may remove or replace either 
the IPL volume or the delta volume, or 
both. If no Delta data sets were speci- 
fied, the operator is notified that he may 
remove the IPL volume. If the Delta volume 
is not removed and it is marked as public, 
it is used as a public volume. If the IPL 
volume is not removed, the 2314 unit that 
it is on is marked as system-dedicated. If 
a Quickstart data set is to be created on 
either the IPL or Delta volume, the demount 
message for that volume is not issued. 

If this was a normal Startup, a test is 
made to see if a Quickstart data set is to 
be created. If so, CEIAB is invoked to 
create that data set. (See Chart AC, p. 8.) 

If any Q-cons were loaded, the pseudo- 
register value is displayed on the printer. 
A subroutine (QRDR) is then invoked to up- 
date the dynamic loader and task common. 
The Q-con hash table and CXD values are 
inserted in the dynamic loader PSECT, and 
the CXD value is placed in task common. 
The current value of the CXD is displayed 
on the printer. 



Now the mainline invokes a series of 
subroutines to do table initialization. 
Startup mainline may now communicate with 
the RESSUP that is now in main storage. 
The first subroutine, Initialize Pathfind- 
ing Tables (SETPTH), partitions channels 
and control units (via RESSUP Pathfinding) 
that are outside the time-sharing system 
environment. The subroutine's functions 
depend on the machine configuration at the 
installation. The routine disables I/O 
interruptions and determines whether or not 
the system is simplex. 

In a simplex system, control bypasses 
the above-mentioned partitioning and goes 
to the Special routine. In a duplex or 
half- duplex system, the subroutine uses the 
switch settings on the configuration con- 
sole, the channel controller and the Corre- 
spondence List tables of the CCB to find 
and partition those channels and control 
units not attached to the system. On 
entry, the following fields are filled in 
with the corresponding parameter 
information: 



SIMDUP 


simplex/ duplex indicator 


CCBAD 


pointer to CCB 


SPATH 


pointer to CEAA5R 


SPATH2 


pointer to CEAA5S 


SSYS 


pointer to CHBSYS 


SSTA 


pointer to CHBSAC 


PAGAD 


address of primary paging 




device 


TERMAD 


address of operator's 




terminal 


VOLAD 


address of IPL volume 


SDABF1 


buffer pointer 


PGSRSDA 


list of drum addresses 


PARTND 


prelude map of parti- 




tioned CPUs 


CREG8-CREG15 


extended control regis- 




ters 8-15 



SETPTH locates the CCU Map in the com- 
munication region which has been filled in 
by Prelude following a configuration analy- 
sis. It searches the table for a CCU found 
to be partitioned. The list of channels 
connected to the partitioned channel con- 
troller is passed on to the Set Path rou- 
tine (CEAA5S) of the Pathfinding module in 
RESSUP, for partitioning. Error checks are 
made and should a channel be found to be 
nonexistent in the Pathfinding tables, an 
error message is sent to the operator. 
CEAA5S does not complete the list if an 
error is encountered, so any remaining 
channels to be partitioned are presented to 
Set Path again. Every CCU is processed in 
this manner. In order to process CUs f 
SETPTH inspects each bit in extended con- 
trol registers 12 and 13. Each bit corres- 
ponds to a CU switch setting. If the par- 
ticular CU is attached to a CCU, the bit 
setting is on. If partitioned, the setting 
is off. There is a Correspondence List in 
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the CCB which shows the paths in variable 
number of halfword entries of each switch 
represented in extended control registers 
12 and 13. SETPTH obtains the address of 
this list. It determines which paths are 
to be set as partitioned in the Pathfinding 
tables and builds a path list as obtained 
from the Correspondence List. CEAA5S is 
then invoked to partition the list and the 
same error procedures are followed as for 
CCUs. Once all the CUs have been pro- 
cessed, control is sent to the Special 
routine. 

The Special routine creates the follow- 
ing special device path tables: 

SERR/Reconfiguration Path table 
Operator's Device Path table 
IPL Volume Path table 

Pointers to these tables are set in the 
appropriate fields of the System table. 
Special begins by copying extended control 
registers 8-15 into the System table, and 
calls on the RESSUP Reverse Pathfinding 
routine (CEAA5R) to obtain the SDA of the 
paging volumes. The operator's terminal 
address is stored in the System table, and 
its SDA is likewise obtained. Should 
CEAA5R return an indication that an asynch- 
ronous interruption entry does not exist in 
Pathfinding for the terminal, or that the 
terminal cannot accept asynchronous inter- 
ruptions, a diagnostic is issued (via OPER) 
and Startup terminates. Otherwise, SETPTH 
finds the entry in the CHBSAC for the SDA. 
This provides a pointer to the Device Group 
table. 

The Operator's Device Path table is 
created from information provided by the 
above-mentioned tables, in the form of 
fullword entries. DIRSIZ is invoked to 
obtain available storage for the table. 
The Operator's Device Path table is moved 
and the System table is initialized with 
the number of entries and the location of 
the Operator's Device Path table. Should 
an error occur in obtaining or attempting 
to find the SDA, the creation of the Opera- 
tor's Device Path table is bypassed but 
processing continues. The same process is 
followed if the IPL Volume Path table can- 
not be found. 

The SERR/Reconfiguration Path table is 
created only if drums are present in the 
system. A list giving a path to each drum 
is provided as input to Special. The SDA 
for each entry is obtained again via 
CEAA5R, and is stored back in the list. 
The SDA is used as above to locate all 
paths to each drum. Each first halfword of 
each fullword entry in the path table is 
set with the SDA+1 of each drum. Any 
errors are handled as described above. On 
exit this output is generated: 



PPDSDA SDA of paging drum 

TERSDA SDA of operator's terminal 

VOLSDA SDA of IPL volume 

PGSRSDA list of SDAs for all drums 

Certain fields of the CHBSYS 

Three Path tables 



Control now returns to the mainline 
routine. 

Mainline now invokes PGXTSI, a subrou- 
tine used to complete the initialization of 
the XTSI, XPT, and XSPT. If the system is 
duplex or ha If -duplex, the routine also 
gathers the information which is to be 
loaded into extended control registers 4 
and 6 later on in Startup. The CCT table 
in the CCB is used to determine the channel 
controllers and channels in the system. 
One word, CREG4, is initialized to repre- 
sent the channels in the system. (This 
word is also initialized for a simplex sys- 
tem.) A second word, CREG6 , is initialized 
to represent the channel controllers in the 
system and, in a duplex system, indicate 
that the malfunction alert fields are 
enabled . 

Initialization of the XPT/XSPT is com- 
pleted by invoking LOCXPT to find the ori- 
gin of the XPT/XSPT and then storing the 
SDA of the paging device in the first two 
bytes of each XPT/XSPT entry. 

XPT2 and XPT3 are now located in the RSS 
Communication table. The symbolic device 
address of the paging disk is initialized 
in each entry. 

Startup calls the Reserve Pages routine 
(RESRVP) next. The Reserve Pages routine 
reserves as many pages for RSS on the pag- 
ing disk as there are RSSSUP and Symbol 
table pages. These pages will contain 
images of those read-only pages of the 
Resident Supervisor which will be overlaid 
when RSS is loaded. 

The external address of each reserved 
page is stored in an XPT4 entry in the RSS 
Communication table. 

The next routine invoked is BFRPGET. 
Two pages of supervisor main storage are 
obtained (via GETMEM) , the first to be used 
as the first page of CHBTCT, and the second 
to be used as the first page of CHBBFP. 
The real storage addresses of these two 
pages are converted into page table format 
(halfword block addresses) and are stored 
in the Shared Page Table entry reflecting 
the virtual storage addresses assigned to 
the TCT and BFP. 

INTDE is invoked next to initialize all 
RTAM tables: CHBTDE, CHBTCT, CHBDEV, 
CHBBFP, and CHBMTS. See the section 'RTAM 
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Initialization 1 for more information on 
these tables. 

The next routine invoked is SDATRT, the 
SDAT Processing routine. It is used to 
initialize the SDAT and to provide various 
device-related information for use by 
Startup, On entry, the following input is 
located in the communication region: 

SSDATL address of XSPT entry for SDAT 

pages 
SSDAT VMA of SDAT header 
SDALST VMA of first entry in SDAT 
SSDATP number of external SDAT pages 
PAGAD physical address of paging 

drum 
PPDSDA SDA of paging drum 
SPDSDA SDA of paging disk 
VOLSDA SDA of IPL volume 
VSSDAT VMA of VSS SDAT 
RSSDATL location of first RSS XPT 
RSSDATP number of RSS SSDAT pages 
SSSDAT location of RSS SSDAT header 
SPVTP number of PVT pages 
SPVTL address of XSPT entry for PVT 

pages 

The SDAT is a shared virtual storage 
table consisting of an 8-byte header and a 
variable number of 6 4- byte entries. The 
header and each entry begin on doubleword 
boundaries. Entries are arranged in 
ascending order of SDA fields. The SDAT 
resides on more than one page, but does not 
necessarily begin or end on a page 
boundary . 

Concurrent with processing of the SDAT 
is processing of the Support System Device 
Allocation table (SSDAT) and the Public 
Volume table (PVT) . SSDAT combines infor- 
mation currently in SDAT and Pathfinding 
tables. SSDAT consists of a header and a 
body portion. The header includes pointers 
and entries for the operator's console and 
three RSS residence devices. The body con- 
sists of entries for all symbolic devices 
defined in the system. 

Both the header and body are initialized 
by the SDATRT routine. Entries for the 
operator's console, primary paging device, 
and secondary paging device are made in the 
SSDAT header. The VAM-f ormatted flag is 
set for the paging disk. The header to be 
placed in RESSUP (CHBECXRA) , has adcons 
pointing to the first and last SSDAT 
entries in the RSSSUP SSDAT (CHBECXRB) . 
The header to be placed in SYSIVM has 
adcons pointing to the first and last SSDAT 
entries in the SYSIVM SSDAT (CHBECXVA) . 
Startup resolves these adcons, which were 
initialized by SYSGEN. 

The maximum number of possible volumes 
allowed in the system is determined during 
system generation. This number is set in 



the PVT header field PVTMCT and space is 
allocated by SYSGEN for as many entries as 
indicated by this field. Startup initia- 
lizes the volume serial number, symbolic 
device address, device code, and pages 
relocated flag for each legal public volume 
that it encounters. 



SDA500, a routine within the SDATRT, is 
called to process individual 64-byte SDAT 
entries. RESSUP Pathfinding is invoked to 
determine whether a path is available to 
the device whose SDA is being processed. 
If it is not available, the available flag 
is set off and the partitioned flag is set 
on. No further processing is required, and 
control is returned to the SDATRT mainline. 
If there is an available path, RESSUP 
Reverse Pathfinding is invoked to free the 
path. Control is returned to the mainline, 
unless the device is direct access, in 
which case the device type returned by the 
Pathfinding subroutine is checked. 

If the device is a 2301 drum and appears 
in the list of accessible drums (PGSRSDA) 
established previously in Startup by DMLST 
and Special, a variable byte entry for the 
drum is entered into the Auxiliary Storage 
Device List (ASDLST) created by SDATRT. A 
count is kept of auxiliary devices in the 
field DEVTOT. If the drum is not in 
PGSRSDA, the partitioned flag is set on, 
and the available flag is set off in the 
SDAT entry. Control returns to SDATRT 
mainline. 

At this point, it is known that the 
device is either a 2311 or a 2314. The ex- 
ternal storage, available, not reserved, 
and IOREQ allowed flags are set on in the 
SDAT entry. The SDA of the device is then 
compared with the SDA given earlier for the 
paging disk; if the SDAs are the same, the 
auxiliary storage, reserved, IOERQ not 
allowed, private, and not available flags 
are set on in the SDAT entry. If the SDAs 
are not the same, processing continues. 
The volume identification is then read from 
the disk and checked to see if the disk is 
VAM2 -formatted. If it is not, it is 
assumed that the volume is SAM- formatted . 
In this case, the format-4 DSCB is read and 
the device constants and gross available 
space data are set in the SDAT entry from 
the VTOC DSCB. The appropriate flag in the 
VTOC DSCB is examined to determine whether 
the device is private or public and the 
corresponding flag bit set in the SDAT 
entry. If the volume is public, it is 
placed in the public volume chain and a 
check is made for the ACV volume (public 
volume 0) . If the volume is the ACV, it is 
checked to see if the SYSCAT and SYSSVCT 
data sets are on the volume. If they are, 
their pointers are placed in the TDT; if 
they are not. Startup terminates. 
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If the disk is VAM2 -formatted, it is 
checked to see if it is the IPL volume. If 
it is, and if the volume is still mounted, 
the external storage, unavailable, and 
reserved flags are set en in the SDAT. If 
the device is not the IPL volume, or if the 
volume has been dismounted, processing con- 
tinues. The current device is again 
checked to see if it is the secondary pag- 
ing volume; if it is. Initial Virtual 
storage extents are moved to the auxiliary 
device list and the PAT page is read in. 
If it is not, the secondary paging volume, 
a check is made to see if a paging pack has 
been mounted. If it has (X^O' in byte 17 
of the volume label) , the auxiliary 
storage, private, unavailable, reserved, 
and IOERQ not allowed flags are set on in 
the SDAT. 

If no paging pack is mounted, the 
public/ private flag in the volume table is 
checked. If the public flag is not set, 
the volume is marked private in the SDAT. 
If the public flag is set on, the volume 
serial number, the current symbolic device 
address and the device code are inserted 
into the appropriate PVT entry. Startup 
determines which entry in the PVT will be 
initialized for this volume by examining 
the relative volume number field in the 
volume label. If the relative volume num- 
ber exceeds the maximum allowable limit, 
Startup issues a message to the operator 
indicating the device address and the rela- 
tive volume number of the volume in ques- 
tion. Startup then asks the operator to 
remove or replace the volume, and after 
doing so, reprocesses all pertinent tables. 
If the PVT entry corresponding to the 
volume being processed has already been 
initialized. Startup issues a message to 
the operator indicating the symbolic device 
addresses of the two duplicates and their 
relative volume numbers, and asks the 
operator to remove one of the volumes. 
Startup then reprocesses all pertinent 
tables. 

If the volume qualifies on both of the 
above-mentioned checks, its PVT entry is 
initialized as described above and it is 
entered in the public chain. The PAT for 
this volume is also checked to determine 
whether this volume contains pages which 
have been relocated by the RESTORE program. 
If so, the pages relocated flag is set in 
the PVT entry for this volume. 

Startup reads in the PAT table for all 
public and auxiliary volumes. It examines 
each PAT entry and maintains a count for 
every entry that represents an unused page 
(X'OO 1 ). It also examines each data page 
entry (X'Ol') to determine if the Allocated 
flag is set. If an entry is found iX'Ul 9 ), 
it is cleared and the available count 
incremented. The accumulated available 



page count is stored in the PVT entry for 
the volume. The PAT table is then rewrit- 
ten to external storage to reflect the 
change. This is done when a page assign- 
ment is made from the volume which requires 
the rewriting of the PAT table. If the 
volume being processed is auxiliary 
storage, the PAT information is used to set 
up the auxiliary storage allocation bit 
directory. If the volume is public 
storage, the PAT information is used to set 
the Available Space field for the volume in 
the Public Volume table (PVT) and to recov- 
er lost space from the volume. 

The PAT for each public volume is mapped 
into shared virtual storage by initializing 
the next available entry or entries with 
the external address of the PAT. (The vir- 
tual address of the PAT is determined by 
the relative XSPT entry.) The virtual 
address and relative page number of the PAT 
are then placed in the SDAT entry for that 
volume . 

A flag is set in the XSPT entry to indi- 
cate that this virtual page resides on ex- 
ternal rather than auxiliary storage. 

If, when trying to gain access to a 
device, during any part of this processing, 
Startup finds the device to be malfunction- 
ing, the phased out flag is set on, the 
■available* flag is set off in SDAT, and 
the device is set as malfunctioning in the 
pathfinding table. If a direct access 
device is located and has an available 
path, but is not mounted, further proces- 
sing is bypassed for that entry. 

After all SDAT entries have been pro- 
cessed, a check is made for missing public 
volumes. Startup has kept track of the 
highest relative public volume it has 
encountered. This information is used to 
initialize the PVTECT field (actual volume 
count) in the PVT header. All PVT entries 
up to the one with the highest volume num- 
ber encountered are then examined. If any 
of these entries have not been initialized, 
Startup issues a message to the operator 
indicating which relative volume numbers 
are missing. Startup then asks the opera- 
tor to mount the missing volumes on any 
available drive, after which all tables and 
their entries are re-initialized. 

WRXTSI writes the XTSI on the paging 
drum, and the head and slot number of the 
XTSI page on the drum, and its SDA, are 
saved in the System table. LOCXPT is 
invoked, with the SPT pointer as input, to 
determine the address of XSPT. The SDA of 
the paging drum is set in the first two 
bytes of each 12-byte XSPT entry corres- 
ponding to a virtual storage address allo- 
cated by Startup. Control returns to the 
mainline. 
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ASATRT is invoked next. This routine 
initializes the Auxiliary Storage Alloca- 
tion table (ASAT> , which is used to control 
allocation of pages on auxiliary storage 
devices. It is first set up for the paging 
volumes. After the execution of Startup, 
pages in use on the paging drum are those 
occupied by shared IVM, SERR/Re con figura- 
tion path table, the skeletal XTSI and the 
Shared Data Set table. If the paging 
device is a disk, the unavailable pages are 
PAT pages, IVM pages and error pages. 

The extents of the unavailable pages on 
each auxiliary device have been previously 
set up by the SDATRT. SDATRT uses informa- 
tion from the PAT for each auxiliary disk 
plus information gathered by the Link- 
loader routines to make this determination. 
It is important for Auxiliary Storage Allo- 
cation to know exactly which pages it may 
utilize so that Supervisor time is not con- 
sumed trying to use malfunctioning or occu- 
pied pages. Additionally, ASATRT initia- 
lizes count fields for each cylinder on an 
auxiliary disk. These fields indicate the 
number of pages available on each cylinder. 
This makes it possible for the Supervisor 
to minimize seek time by minimizing the 
number of cylinders on which it has to per- 
form write operations. 

The highest external page number on the 
paging drum (the XTSI page) is supplied by 
the PGXTSI routine. Pages occupied by 
SERR/Reconfiguration are provided by the 
SERR100 and SERREND routines for each drum 
in the system. 

On the paging drum, pages 882-890 are 
reserved for standard error retry proce- 
dures. Page 885 is unavailable because of 
error problems. Checks are not made for 
bad pages on either drum or disk. Bit 
directories for 2311 or 2314 disks include 
only 199 cylinders, since the last four are 
reserved for standard error retry proce- 
dures . 

The number of auxiliary storage devices 
as determined by the SDAT routine is 
checked to determine whether there are any 
additional devices for which to set up 
tables. If there are, the device type in 
the auxiliary storage device list is 
checked and the appropriate table is 
created. These bit directories reside in 
real storage immediately following the 
Resident Supervisor. 

The directories for devices of the same 
type are chained together as each table is 
built. The following information is 
updated in the ASAT header: number of 
drums, number of drum pages available, num- 
ber of auxiliary disk pages available, 
address of the first disk directory, and 
address of the first drum directory. For 



each bit directory, a subheader is also 
filled in with the following information: 
number of pages available on drum or disk, 
SDA, address of next drum or disk, direc- 
tory in chain (a circular chain where last 
points to first). In disk directories, a 
subheader is filled in with the number of 
bytes in the directory. After all direc- 
tories are built, the low drum availability 
threshold is calculated and entered in the 
ASAT header. 



Startup reads in the System Common 
(CHASCM) and uses the value in SCMAUX to 
calculate a new value for the augmentation 
of auxiliary storage which is stored (over- 
lays) in SCMAUX and the System Common is 
rewritten to auxiliary storage. 

If a new Quickstart data set has just 
been created on a public volume, the rela- 
tive public volume number, the relative 
page number, and the slot number for the 
E-DSCB are set in System Common for use by 
CZACB. The third level data set name qual- 
ifier (DSxxxxxx, where xxxxxx is the volume 
identification on the pack) is also put 
into System Common at this time. 

Once the tables have been set up, the 
reserved list (five pages) is set up for 
use by Supervisor Core Allocation, and a 
list containing pointers to these pages is 
built. Control returns to the mainline. 

The next routine invoked is ANZSDA, 
which analyzes all the direct access 
devices attached to the system. The SDAT 
table (CHBSDA) and the PAT pages for each 
device are examined for the following 
information for each device: 

• The symbolic device address 

• The physical device address 

• The device type (2311, 2314, or 2301) 

• The status of the device (partitioned, 
not ready, etc.) 

• The relative volume number of the pack 
on the device (if public) 

• The number of available pages on the 
device 

• The VOLID of the pack on the device. 

The PAT pages are checked for validity 
to insure that for each device: 

• Relative page zero has a PAT entry of 
X'CO" 

• The PAT self -descriptor entries are 
X f 7F f 
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• The byte following the last PAT entry 
contains X'FF f 



• No other entry except the last byte 
following the last PAT entry contains 
X'FF' . 

The result of the analysis is displayed 
on the printer. 

If any of the above checks fail, the 
SDAT entry (SDAINV) corresponding to the 
device being processed is marked X^O*, the 
number of available pages in the Public 
Volume table is set to zero (if the device 
is public) , and, after all devices have 
been processed the entire SDAT and PVT 
tables are re-written on the primary paging 
device. A message is sent to the operator 
informing him of an invalid PAT on the 
device being processed. Control then 
returns to the mainline. 

The next routine called is the Allocate 
SERR Operating Pages routine (SOAPGS). 
This routine allocates real storage to be 
used as the operating area for System Error 
Recording and Retry. SOAPGS uses GETMEM to 
search for the storage area. An attempt is 
made to allocate the two-page operating 
area in the same storage area as the active 
PSA. Since it is possible to have more 
than one PSA (in duplex mode), there may be 
more than one two-page SERR operating area. 
The address of each area allocated is saved 
in its corresponding PSA, in the field PSA- 
SOA. If no area is available*, the field is 
set to zero, and control is returned to the 
mainline. 

The JPSA routine is invoked next. It 
uses information in the communication 
region pertaining to the number of CCUs and 
SEs in the system, together with the CPU 
Status table of the CCB, to initialize the 
CPU Status table in the PSAs for each CPU 
in the system, excluding the initially- 
loaded CPU. It does this by locating the 
SE section of the CPU Status table in the 
CCB, extracting appropriate information, 
and storing it in the PSA CSTs. Informa- 
tion in the communication region pertinent 
to JPSA is as follows: 

CCBAD pointer to CCB 

SES IDS SE Map Of IDS 

CPUSTSS number of CPUs in TSS 

PSAS list of active PSAs for the 
CPUs 

RESTART RESTART indicator 

OTHCPU map of IDs of non-IPL CPUs (if 
applicable) 



The floating storage address for each SE 
in the installation is initialized in the 
SE entries, as taken from the extended con- 
trol registers for a duplex or half-duplex 
system, or from the operator input for a 
simplex system. The number of SEs is 
stored in a field called SETOT. The parti- 
tioned flag is set on for all those SEs 
that are partitioned from the system. The 
number of CPUs in TSS is set in the CST 
header. If the count is greater than one, 
a new machine check PSW is placed in the 
PSA buffer for the loaded CPU. This buffer 
will be moved to the real PSA for this CPU 
at the end of Startup. All other PSAs are 
initialized now. In the event of a 
restart, if a CPU is failing, its entry in 
the CPU Status table is set with the mal- 
functioning bit on. Partitioned CPUs are 
set as such in their PSAs. 



The inactive prefix indicator for pri- 
mary or alternate prefixes is set in the 
CPU Status table entry for each CPU in the 
system. Now CPU entries are rearranged in 
the CPU Status table so that the entry for 
a CPU will appear as the first entry in its 
copy of the table. The IDs of CPUs are 
stored in a byte (WRDCT) to be used by the 
Intercom routine for issuing an external 
start. The MTS fields MTSMAX and MTSTLM 
are set to the value found in CCBCON and 
the MTSCUR fields is set to 1. 



The SAR is read in and the SARMCN and 
SARCNL fields are set to the volue found at 
CCBCON. The SARMMA and SARMAL fields are 
set to the value from CCBMTT, the SARMBT 
and SARBTL fields with the CCBBAT value, 
and the SARMRM and SARRML fields are set to 
the CCBBAK value. Control is now returned 
to the mainline. At this point RELMEM is 
called and all the pages that have been 
reserved for Startup are released in the 
Page Map. 

SCBTL is invoked for the initialization 
of the Core Block table. The Page Map, 
created by the main storage analysis done 
in Prelude, and updated by routines in 
Startup, provides input for this routine. 
Now each byte within the map reflects the 
condition of its corresponding page of real 
storage. The byte settings and their mean- 
ings are: 



3C = user page 

88 = failing page (machine check 

detected during storage analysis) 

94 = partitioned page (addressing inter- 
ruption during storage analysis) 

DC = RESSUP page 
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FC = reserved for RESSUP 



SCBTL moves the bytes from Page Map to 
their corresponding entries in the CBT, and 
initiates the user page chain. All entries 
flagged as user pages are chained with both 
forward and reverse links. Two entries in 
the CBT header are filled in: a pointer to 
the user chain and the number of user 
pages. Control passes to P4800X. 

This routine sets the storage protection 
keys for each half page block of main 
storage. It bases these settings on the 
flags in each byte of the Page Map. The 
keys and their meanings are: 

1 = user page 

5 = RESSUP page 

4 = reserved for RESSUP 

If the page is partitioned or failing it is 
not assigned a key. Control now passes to 
the CRRSPI (Create RSPI) routine. CRRSPI 
calls Supervisor Core Allocation to assign 
main storage for the SPTs and XSPTs. The 
SPT/XSPT is then moved to the area reserved 
by Supervisor Core Allocation. The SPT/ 
XSPT origin is stored in the RSPI. 

PARTMP is then called to analyze the 
Core Block table and the partitioning reg- 
isters, and to display on the printer a map 
of all storage on the system during this 
Startup. The information printed 
describes: 

• Each storage element (A through H) 

• The CPU (none, 1, 2 r or both) the SE is 
connected to 

• The real storage location of any pages 
in error (failing storage locations are 
indicated by a Core Block table entry 
of X'88') 

• All partitioned storage. 

ENDABLE is called at this point to re- 
initialize each terminal line. Now any 
user who dials in on a dedicated terminal 
will interrupt the system and request to 
log-on. In order to do this a disable fol- 
lowed by an enable is issued to every line. 
Each line is then inspected to determine if 
the line is valid, and if the correct data 
set line adapter is specified. For each 
dedicated line, a Prepare command is sent 
out. If during Endable an unrecoverable 
I/O error occurs. Startup calls Reverse 
Pathfinding (CEAA5R) and pathfinding 
(CEAA5P) respectively to determine if the 
control unit was partitioned at SETPTH 
time. If the unit was partitioned, Startup 
ignores that bank of lines; if the control 
unit is available, and Startup is able to 



perform successful I/O to other lines on 
that particular group, a malfunction mes- 
sage is sent to the printer; if no success- 
ful I/O is performed on a group of terminal 
lines, pathfinding (CEAA5S) is called to 
partition the control unit, and a message 
is written to the printer. At the end of 
the ENDABLE routine, if any message was 
written on the printer, an appropriate di- 
agnostic message is sent to the operator's 
console. 

SETTSK, the subroutine to create the 
Main Operator's task, creates a TSI with a 
task ID of 1, creates a GQE pointing to 
this TSI, and queues the GQE on the TSI. 
Task Initiation (CEAMT1) sets up a TSI and 
returns a pointer to it. The pointer is 
stored in the asynchronous interruption 
entry for the operator's terminal in the 
Device Group tables (Pathfinding) . Certain 
fields in TSI are set; the task ID is set 
to 1, the system operator priority flag is 
set on, the interruption pending flag for 
an asynchronous task is set on, and the 
intertask acceptance flag is set off. A 
6 4- byte GQE is provided by Supervisor Core 
Allocation (CEAL1A) . Stored in this GQE is 
a pointer to the TSI, an interruption code 
(a path to the operator's terminal), and 
the symbolic device address of the opera- 
tor's terminal. This GQE is now queued on 
the TSI's asynchronous interruption queue, 
via the Queue GQE on TSI routine (CEAAFQ) . 

The QSCNPSA routine is invoked and 
Startup exits directly to the Queue Scan- 
ner. The SPSABUF routine is called to move 
the PSA of the initially-loaded CPU from 
the PSA buffer to its preassigned location 
in main storage. 

At this point, if there are any other 
CPUs to be started up in the system, Inter- 
com is invoked to issue external starts to 
them. 

When the other CPUs are ready, the 
initially-loaded CPU sets a flag and exits 
to the Queue Scanner. This flag acts as a 
signal to the other CPUs that they may now 
exit to the Dispatcher. 

Startup is complete, and an operable 
TSS/360 has been created. 



LINK-LOADER MAINLINE 



Link-Loader ( EIAA5 ) 

Chart AC, Page 2 

During Startup, the Initial Virtual 
storage routines in TSS*****. SYSIVM and IVM 
Delta data sets are link-loaded onto system 
paging devices. The Resident Supervisor 
routines in TSS*****. RESSUP and RESSUP 
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Delta data sets together with the Resident 
Support System routines in TSS*****.RSSSUP 
and RSS Delta data sets are link- loaded and 
written into main storage or the paging 
disk respectively. Startup uses a CSECT, 
called a load list, within ecich data set to 
determine which CSECTs must be loaded for 
Initial Virtual storage and the Resident 
Supervisor. 

The operator or card reader input pro- 
vides for loading: 

• Alternate load lists. 

• Alternate and/or additional CSECTs. 

Prior to searching the system data set 
SYSIVM (RESSUP) , Startup looks for the load 
list in a hierarchy of data sets specified 
by the operator or by card reader input. 
When the load list is found. Startup 
enables the operator (from the operator's 
terminal or the card reader) to exclude the 
loading of certain csects. The message 

ENTER CODE FOR FUNCTIONS NOT TO BE 
LOADED. ALL FUNCTIONS WANTED=EOB 

prompts the operator for the codes of the 
messages to be excluded. STARTUP does not 
load those modules that have the selected 
function code in the last byte of the load 
list entry. When the codes have been 
entered, Startup sequentially retrieves and 
loads each CSECT named in the load list but 
not excluded; again, the hierarchy of data 
sets specified by the operator or by card 
reader input is searched before the system 
data set. In the case of user modules, 
either the module name or a CSECT name can 
appear in the load list. In either case. 
Startup loads all CSECTS in the module. 
The System Programmer's Delta data sets 
remain in the system from Startup to shut- 
down. CSECTs in these data sets will over- 
ride versions of the same CSECTs which 
reside in the system data sets. Programs 
of each user who logs on during this ses- 
sion will run with all of these modifica- 
tions to Initial Virtual storage, the Resi- 
dent Supervisor and the Resident Support 
System. 

If Delta data sets are requested, a list 
of Delta data set names and their hierarchy 
numbers is printed out. 

The Link- loader interrogates a load 
switch set by the Startup .-mainline to 
determine whether to load Initial Virtual 
storage or the Resident Supervisor/Resident 
Support System. The mainline initially 
sets the switch to one so that Initial Vir- 
tual storage is loaded first. The switch 
is zero when the Resident Supervisor/ 
Resident Support System is to be loaded. 
The name of the data set currently being 



processed is stored in location DSNAM. 
DSNAM is tested at various points in the 
code to determine if Initial Virtual 
storage. Resident Supervisor, or Resident 
Support System is being processed. Most of 
the associated tables are initiated in this 
routine. 

Input to the Link-loader consists of the 
RESSUP, RSSSUP and SYSIVM data sets (which 
reside on the IPL volume) , as modified by 
those Delta data sets that have been speci- 
fied by the operator or by card reader 
input. (No Delta data sets need be speci- 
fied, in which case no modification will 
take place.) The Link-loader can then be 
divided into the following three logical 
sections: 

SECTION ONE is used for processing Ini- 
tial Virtual storage. Resident Supervisor 
and the Resident Support System. 

Initial housekeeping is performed upon 
entry. Base registers are initialized, and 
CCW addresses are relocated during Initial 
Virtual storage processing. 

Throughout IVM processing, whenever a 
reference is made to a PMD group, a PMD, or 
a CSD, a test is made to determine if pag- 
ing has been done. If so, PAGTDY is called 
to insure that the page is in main storage 
before processing continues. Whenever a 
real storage address is specified, it could 
be a virtual real storage address, in which 
case paging could be done. 

If Delta data sets are to be loaded, the 
address of the Delta volume and names of 
the Delta data sets must be supplied by the 
operator or by input from the card reader. 
If card input is used, cards are read until 
an end-of-file condition occurs or a card 
with END in columns 1-3 is encountered. 
Each name is checked for the required for- 
mat. If a name is valid, it is entered 
into one of three lists. When the lists 
are complete, they specify the hierarchy of 
search for data sets in Initial Virtual 
storage, the Resident Supervisor and the 
Resident Support System, respectively. 

The volume label and PAT pages are then 
read from the Delta data set volume. A 
check is made to see if the specified Delta 
data sets exist on the volume. For each of 
the data sets, the following procedure is 
carried out. 

The DSCB is read into DSCBF, and the 
EXTENT routine is called to pick up the 
external page numbers on which the data set 
resides. An internal table, EXTAB, is then 
created, consisting of 6-byte entries con- 
taining extent information. The number of 
Partitioned Organization Directory (POD) 
pages is found in the format-E DSCB for 
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each data set. Buffer space is allocated 
for these pages, and the starting address 
of the POD is stored in the CCW list for 
reading the POD, Then, for every page of 
POD, EXTAB is searched to determine the 
location of the page- The first POD page 
is virtual page of the data set. (These 
POD pages temporarily occupy a portion of 
the area later used for the TDY. ) The 
first page is read in, and the CCW is 
updated to point to the next higher page. 
If the POD is missing or incomplete for a 
given data set, a diagnostic message is 
issued. If no POD can be found (System or 
Delta) comprising Initial Virtual storage, 
the Resident Supervisor or the Resident 
Support System, Startup is terminated; 
otherwise Startup continues. 

LOADL is called to perform the following 
function for processing Initial Virtual 
storage, the Resident Supervisor and the 
Resident Support System. Beginning with 
the POD for the first data set in the 
hierarchy, a search is made for the load 
list member descriptor. The search con- 
tinues sequentially through the hierarchy 
until a load list is found. Now the 
address of the input buffer is located from 
INPTAD, and moved to the CCW list used to 
read the load list CSECT text pages. LOADL 
computes the size of the buffer area for 
the load list text and saves the starting 
address in LDTBL. The list contains only 
the names of the CSECTs to be processed by 
the Link- loader. A hierarchical search 
through each data set is conducted for each 
CSECT name in the load list. The PODs are 
searched in hierarchical order until all 
CSECT names are located. Then the hierar- 
chy number of the data set in which a CSECT 
is located is entered in the load list 
entry for that CSECT. The first virtual 
page number of the module in which the 
CSECT is located is taken from the member 
descriptor in the POD, and also placed in 
the corresponding load list entry for that 
CSECT. For quick access to any name in the 
load list, a hashing table is created by 
the routine LLLNK. 

Note: For LOADL processing of user 
modules, the module name, or any CSECT name 
in the POD, is sufficient to cause all 
CSECTs in the module to be loaded. 

Next, the routine BGNTDY is called to 
initialize the TDY heading area. More 
pages are allocated for Initial Virtual 
storage heading than for the Resident 
Supervisor/Resident Support System heading, 
due to Initial Virtual storage's greater 
size. The pages provided are contiguous, 
with area set aside for the paging of TDY, 
and the starting location of the Task Dic- 
tionary table (TDY) is stored in location 
TDYAD. Since the TDY for IVM may exceed 
the main storage limits. Startup pages all 



the TDY in excess. The number of resident 
TDY pages varies with the configuration as 
follows : 



2 storage boxes 

3 storage boxes 

4 storage boxes 



64 pages 
128 pages 
288 pages 



All TDY pages in excess are written on the 
drum and paged as necessary during system 
operation. The page table entries describ- 
ing each of these pageable TDY pages con- 
sist of 16 bytes : 

Bytes 0-3 — virtual page address 



Bytes 4-7 



— number of pages 
in PMD group 



Bytes 8-11 — external address on drum 

Bytes 12-15 — virtual address of 

beginning of PMD group 

Then the BLDTDY routine is called to build 
the TDY. This routine performs another 
scan of the load list entries. Program 
module dictionaries (PMDs) for all entries 
in the load list are linked into the TDY. 
(Any individual PMD may be applicable for 
more than one CSECT.) For user modules, 
any CSECT in the PMD that is not in the 
load list has a load list entry generated 
for it at this time. For each load list 
entry, the following information is 
incorporated : 

• A pointer to the Control Section Dic- 
tionary (CSD) . 

• An updated virtual page number 
(reflecting the displacement of the 
CSECT within the module) . 

At this point, DSNAM is checked to see 
if RESSDP is being processed. If so, then 
DSNAM is modified to indicate that RSSSUP 
is to be processed concurrently with 
RESSUP. The same process of building a 
Delta data set name list, locating the load 
list, and locating each CSECT in the load 
list is followed for RSSSUP. The PMDs for 
RSSSUP are linked into the same TDY as 
those for RESSUP. Therefore, when FIXPMD 
is invoked, all cross-references between 
RESSUP and RSSSUP modules are resolved. 

In the FIXPMD routine, standard entry 
points and complex definitions are resolved 
for each PMD. 

Next the MAPGEN routine is called to 
create the Memory Map table in the TDY 
heading area. These entries are created in 
ascending sequence of CSECT base addresses. 

SECTION TWO is used for processing only 
the IVM data set(s). 
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Two previously created buffers are used 
to process the initial virtual storage page 
tables: XTSI buffer and Shared Page table 
buffer. First the segment and page tables 
are created. The Segment table 1ST) con- 
tains: a full word entry per segment, the 
displacement (relative to the XTSI origin) 
of the segment Page table <[PT) , and a PT 
availability indicator, a in bit 31. 
Segment is used to store private CSECTs 
(containing information pertinent to a spe- 
cific user or task). The TSI and the XTSI 
are used to keep track of specific tasks. 
Segment l f s entry contains the number of 
pages in the segment and the PT availabili- 
ty indicator, a 1 in bit 31. This is a 
shared segment, and its page tables reside 
in real storage. If there is public or 
private segment overflow, additional Page 
tables are created and their addresses are 
placed in the corresponding Segment table 
entries. CSECTs in the shared segments are 
public CSECTs, so their page tables are 
applicable for all users. 

Next, the Auxiliary Segment table (AST) 
is created with a doubleword entry per seg- 
ment. Segment O's entry has a bit set in 
the flag byte, indicating that the segment 
is assigned. The entry for segment 1 has 
bits set to indicate the segment is 
assigned, shared, and that the page tables 
are in main storage. The Shared Page table 
number is stored in the fifth byte. The 
entries for the remaining ssjgments (2-15) 
are zeroed. Every time a page is assigned 
a segment virtual address, a Page table 
and an External Page table (XPT) entry is 
made in the XTSI. For ever]? virtual 
address assigned to segment 1, an entry is 
made in the SPT and XSPT. The LOCXPT rou- 
tine is invoked to create dummy page table 
entries, in the event there is an odd numb- 
er of pages in the segment. This also 
returns the origin of the XPT or XSPT, as 
well as the address of the location follow- 
ing the XPT or XSPT. FORMPT is then called 
to create PT and XPT entries for segment 0, 
or SPT and XSPT entries for segment 1. The 
same procedure is followed for additional 
public or private segments. Then Link- 
loader sets the 'update in place* flag in 
the XSPT entries of all the SDAT pages. 
Construction of the PT/XPT is accomplished 
via the XTSIRT routine. Construction of 
the SPT/XSPT is accomplished via the SHPTRT 
routines. These two routines are designed 
to facilitate the construction of Page 
tables for overflow segments. 

NAMLOC is called to locate the virtual 
storage addresses for a list of selected 
IVM entry names. These are found in NAM- 
TAB2, and their addresses are stored in the 
communication region. GET EXT is used to 
read the text for each CSECT in the TDY 
storage map. It then modifies the text in 
the buffer, packs it into the the output 



buffer, and writes it on the paging drum 
(in the case of the public segment), or the 
paging disk (in the case of the private 
segment) . If a print map is requested, 
SYMGEN and SORDID are invoked to print a 
storage map of Initial Virtual storage. 
RELTDY is called to convert all the real 
addresses in the TDY to virtual addresses. 
The private segments of Initial Virtual 
storage, and the associated tables, are now 
written onto the paging disk. Next, WRTDY 
is called to write out the TDY pages on the 
paging disk, with the exception of those 
allocated pages not being used. (The XTSI 
is written on the paging drum. ) As each 
page is written, its external page number 
is entered in the appropriate XPT entry by 
the SETPT routine. Zeros are stored in the 
first word of the XPT entry for any unused 
allocated pages. The following fixed areas 
in the XTSI are now initialized: 

A PSW 

The estimated time 

The number of bytes available in the 

first page 
The XTSI page count 
The current timer value 
The user timer value 

The public segments are now written onto 
the paging drum (for minimal access time). 
Any of the allocated pages that are not 
used are not written. The SETPT routine is 
invoked to enter the external page numbers 
in the appropriate XSPT entries. Zeros are 
stored in the first word of the XSPT entry 
for unused pages. The ' update- in-place* 
flag is set for XSPT entries in the SDST. 

The real storage block addresses for the 
first pages of CHBTCT and CHBBFP are placed 
in their respective Shared Page Table en- 
tries. The 'page hold* flag is then turned 
on in the XSPT entries for the first pages 
of CHBTCT and CHBBFP. These are IVM CSECTS 
(tables) used by RTAM, but the first page 
of each must reside permanently in real 
storage (that is, they must not be paged 
out). See the section 'RTAM Initializa- 
tion 1 . 

SECTION THREE processes the RESSUP and 
RS3SUP data sets. 

The NAMLOC routine is invoked to find 
the real storage addresses for the list of 
RESSUP entry names (NAMTAB) . These 
addresses are stored in the Startup com- 
munication region. 

SYMGEN is now called to create the com- 
bined RESSUP/RSSSUP Symbol table. If a 
RESSUP map has been requested it will be 
printed at this time. RCOMTB is called to 
create the RSS Communication table. ADDPGS 
is called to add the RESSUP/RSSSUP Symbol 
table pages to shared IVM. WRSYMTB is 
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called to write the Symbol table onto the 
external pages reserved for it. These 
pages are located on the paging drum. 
RELMEM is called to release the Symbol 
table buffers and GETEXT is called to read 
in the text for each CSECT in the TDY 
storage map. It modifies the text, packs 
it into the output buffer, and then moves 
it to a preassigned location in main 
storage or the paging drum. The PSA 
modules, however, remain in the buffer PSA- 
BUF, and if the PPV is a drum, all drums 
have the SERR/Reconf iguration modules writ- 
ten on them. 

The address of the RSS Communication 
table is inserted into the System table 
field SYSRCT. BDSDST is called to initial- 
ize the Shared Data Set table and create a 
member entry for the RESSUP/RSSSUP Symbol 
table. The SDST is then written on the 
paging drum as a part of shared IVM. Buf- 
fers used by the Link- loader are now 
released and control returns to Startup 
mainline. 

The following describes the Link-loader 
subroutines. 



LINK-LOADER SUBROUTINES 

Create Extent Table (EXTENT) 

This subroutine is called by Link-loader 
subroutines to create a table of extents 
from format-E and format-F DSCBs of a data 
set. On entry, the following fullword 
parameters are passed: 

• Next available location in EXTAB. 

• Total number of pages in the data set. 

• Location of first external page entry 
in format-E DSCB. 

For each extent field, an entry of three 
ha If words is created in EXTAB: 

• First external page number. 

• First virtual page number. 

• Last virtual page number. 

After all extent fields have been pro- 
cessed, an entry of all ones is created to 
mark the end of the EXTAB. Control is then 
returned to the caller. 

Load and Process Load List (LOADL) 

Chart AC, Page 4 

This subroutine scans sequentially 
through the PODs that comprise IVM/RESSUP/ 
RSSSUP to find the load list member des- 



criptor. If a load list cannot be located, 
a diagnostic message is issued and Startup 
is terminated. The module name is CHBVM 
during the IVM processing, CHBRC during 
RESSUP processing, and CHBR5 for RSSSUP 
processing. The routine allocates storage 
for the load list and stores the buffer 
origin in LDTBL. Next it reads the text 
into an input buffer, and moves the text to 
LDTBL. 

A load list entry is five words in 
length, and contains the following 
information: 

• CSECT name (8 bytes). 

• Flag byte 1 (reserved) . 

• Flag byte 2 (=X , 80 f for page boundary 
control, =X , 40 t for read-only flag, 
=X , 10 f for IVM pages SETXP allowed, 
=X , 20' for user modules). 

• Virtual page number of PMD (after the 
PMD is loaded, these two bytes contain 
the addresses of the first virtual page 
of text) . 

• Pointer to CSD for the CSECT. 

• Hash chain pointer. 

• Function byte (for selective loading) . 

Two words of all ones mark the end of the 
load list. 

Begin Load List (BGNLL) 

Chart AC, Page 4 

This subroutine performs the following 
functions : 

• Reads in one POD at a time (according 
to hierarchy) . 

• Links to LLSCAN. After returning from 
LLSCAN, each entry for which a corres- 
ponding name was found in the POD will 
have its virtual page number and 
hierarchy fields initialized. 

• Hashes and links all load list entries 
except those for which no matching name 
was found (LLLNK subroutine). 

Scan Load List (LLSCAN) 



Chart AC, Page 4 

For each POD in the hierarchy that is 
read, this subroutine performs one scan of 
the load list, and searches the POD for a 
CSECT name corresponding to each CSECT name 
in the load list. If a CSECT name was 
found on a previous scan, the entry is 
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bypassed. When an alias is f< 
CSECT in the POD f the related 
criptor is located, and the f 
page number of the member is 
LLVRPN field of the load list 
hierarchy number of the POD i 
CSECT was found is moved into 
the load list entry for that 
For user modules, the module 
CSECT in the load list is suf 
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On the last scan performed by this sub- 
routine, the following procedure is per- 
formed for each CSECT name not found: 

• A diagnostic is issued. 

• The CSECT name is blanked out in the 
load list. 



Begin Task Dictionary Table CBGNTDY) 

This subroutine performs the following 
functions : 

• Allocates storage for TDY heading area, 
and stores the starting address of the 
TDY in TDYAD. 

• Initializes the fields in the TDY head- 
ing area. 



Build Task Dictionary Table (BLDTDY) 

Chart AC, Page 5 

This subroutine performs one scan of the 
load list when processing a RSSSUP or 
RESSUP CSECT. when processing an IVM 
CSECT, three scans are made of the load 
list, one for CHBTCT, one for CHBBFP, and 
one for the remainder of the IVM control 
sections in the load list. TCT and BFP 
must be processed first, since they reside 
in virtual storage, starting at the first 
page of the first public segment in IVM. 
If a CSECT* s PMD has not been loaded, and 
the CSECT is not from a user module, the 
subroutine: links to LDPMC in order to 
load the PMD; links to UP DLL to update the 
virtual page number field (which will now 
reflect the displacement of the CSECT 
within the module) ; initializes the pointer 
to the CSD; and links to ALLOC to allocate 
storage for each CSECT in the load list. 
After the above scans are complete, three 
scans are made for user modules, if any 
exist. The modules are handled as above. 

After the load list scan is complete, 
control returns to Link-loader mainline. 

Load PMD Into TDY (LDPMD) 



This subroutine performs the following 
functions : 



• Links to READIN, to read in the PMD 
pageCs) . 

• Stores the hierarchy number in the 
first byte of the PMD. (If RSS deltas 
are present, the hierarchy number is 
first incremented by the number of 
RESSUP deltas present.) 

• Links to ADDPMD, to allocate storage 
for a PMD in the TDY, and begin ini- 
tialization of the PMD preface. 

• Performs further initialization of 
fields in the PMD preface. 

• Moves the PMD into the space allocated 
for it in the TDY. 

Update Load List (UPDLL) 

This subroutine searches the load list 
for names corresponding to each CSECT name 
in the PMD. If a matching load list name 
cannot be found, a test is made to see if 
this is a user module. If it is not, the 
CSECT is not processed and a diagnostic 
message is issued indicating that that 
CSECT is missing from the load list. 

If the CSECT is in a user module, a load 
list entry for the CSECT name is added to 
the end of the load list, and the new load 
list entry is processed. 

If a name is found that has already been 
processed (because it appeared in a pre- 
vious PMD) , the CSECT is bypassed. If a 
CSECT name is found but the hierarchy numb- 
er does not match that of the current PMD, 
the CSECT is also bypassed. 

If a valid matching name is found, the 
pointer to the CSD is initialized in the 
load list entry, and the virtual page num- 
ber field is updated to contain the CSECT* s 
first virtual page number. 

Storage Allocation for IVM and RESSUP 
(ALLOC) 

ALLOC is called by the BLDTDY subroutine 
for each CSECT name in the load list for 
which the corresponding PMD has not been 
loaded. It allocates real storage for 
CSECTs of the RESSUP data set, and virtual 
storage for CSECTs of the IVM data sets. 
ALLOC also resolves relocatable and abso- 
lute definitions, via the LINK subroutine. 

IVM and RESSUP CSECTs are handled dif- 
ferently by ALLOC, as follows: 

IVM: Control sections are assigned vir- 
tual storage addresses solely on the basis 
of their attributes, with the exception of 
the ISA module, which is allocated a virtu- 
al address of zero. Private CSECTs are 
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assigned virtual addresses starting with 
segment 0, Public CSECTs are assigned vir- 
tual addresses starting with segment 1. 

If a CSECT has its page boundary flag 
set, it is automatically aligned on a page 
boundary. If the page boundary flag is not 
set, the CSECT is assigned a starting 
address at the next doubleword boundary 
within a page, if it does not overflow that 
page- Otherwise, it is aligned on the next 
page boundary, (The only exception to this 
is for the CHBMTS CSECT (Multi terminal Sta- 
tus Control Block) , which is assigned a 
starting address at the next 6 4- byte boun- 
dary.) Paging operations are minimized by 
this set of rules, since no CSECT will 
overflow a page boundary unless its length 
is greater than one page. 

The following rules are followed in 
assigning protection keys for each load 
list entry: If a CSECT is privileged, it 
is assigned a protection key of X'OF'. 
Nonprivileged CSECTs that are read-only are 
assigned a protection key of X'OA 1 . CSECTs 
that are neither privileged nor read-only 
are assigned a protection key of X'OS". 

Note ; If a user module is privileged or 
has the system attribute, a message is 
issued to the printer by ALLOC and the 
privileged attribute is ignored, 

RESSUP: The control sections in the PSA 
page (PSA, CST, Recovery Nucleus, Intercom, 
SERR Bootstrap) are assigned addresses in 
page 0, The SERR/Reconf iguration modules 
are assigned values, simply for sorting and 
identification purposes. In all other 
cases addresses are assigned in lower main 
storage starting at C(LOWAD). Provision is 
made for allocating RESSUP text around 
unavailable main storage by calling the 
GETMEM routine each time a CSECT requires 
main storage outside the last assigned 
page. If the limits of available main 
storage are exceeded, a diagnostic message 
is sent to the operator. The attributes 
are not inspected during RESSUP processing. 

When processing a RESSUP load list 
entry, a check is made for the presence of 
a read-only flag. The presence of this 
flag indicates that this CSECT and all sub- 
sequent RESSUP CSECTs are read-only and may 
be overlaid by RSS. The address of the 
CSECT that contains the read-only flag is 
saved for the RCOMTB routine. The address 
that is saved is actually the address of 
the first page boundary following the 
beginning of the CSECT. CSECTs in RSSSUP 
are assigned virtual addresses starting 
with the beginning of segment 2 of virtual 
storage. 

In either case, RESSUP or IVM, ALLOC 
sets the PMD link in the CSD headings and 



links all relocatable and absolute defini- 
tions by calling the LINK routine. These 
are linked into one of the TDY hash tables. 
Once all the CSDs have been processed in a 
PMD, ALLOC returns control to the LDPMD 
routine. 



Process Complex Definitions in PMD (FIXPMD) 

This subroutine processes standard entry 
point definitions and complex definitions 
associated with a PMD. The module name 
(SEP) is posted in a hashing chain by the 
Hash subroutine. The CSD link of the 
module name DEF is set to all ones. In 
this way, a SEP will never be linked to an 
undefined complex DEF. A search is made 
for the CSD associated with the SEP of the 
module. Its attributes are examined. The 
first CSD having the PROTOTYPE (PSECT) 
attribute becomes the SEP CSD. If there is 
no PSECT, the first CSD becomes the SEP 
CSD. Its address is saved for later pro- 
cessing. The LINK subroutine is called to 
link the complex DEFs in each CSD into the 
hash chains. The CSD links of complex DEFs 
are set to all Is. MODFY processes the 
complex DEF modifier for each PMD page. 
The CSD links of complex DEFs are updated 
to point to the defining CSD, and complex 
DEF processing is complete. FIXPMD now 
picks up the address of the SEP CSD. If 
there are no modifiers for the SEP, the 
V-value and R-value of the first DEF in the 
SEP CSD are stored in corresponding entries 
of the module name DEF. The V-value of the 
module name DEF is initialized by the MODFY 
routine as it processes the SEP modifiers. 
The CSD link is now set to point to the SEP 
CSD. This is the CSD of the CSECT whose 
base defines the R-value of the DEF. If a 
CXD-ref is present, its value is set to the 
current CXD value. Control is now returned 
to the caller. 



Modify PMD and Text Pages (MODFY) 

This is a subroutine to process reloca- 
tion modifiers and perform modifications on 
PMD or text pages. It modifies PMDs when 
processing standard entry points or complex 
definitions. It modifies text when proces- 
sing external or internal references. 
MODFY picks up, analyzes and acts upon the 
relocation modifiers in the PMD. A reloca- 
tion modifier contains the following 
information: 

• Number of bytes to modify. 

• Number of reference whose V- or R-value 
is used to modify the PMD or text. 

• What operation to perform. 

• Starting byte in page to be modified. 
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MODFY receives information from the 
caller. Each parameter is passed in a gen- 
eral register. 

• Number of modifiers for page to be 
modified. 

• Address of first modifier for the page. 

• Address of CSD (or PMD) . 

• Address of PMD preface. 

• Pointer to the page. 

• Address of a reference table. 

If a reference is encountered and has 
not been defined and it is not a Q-ref or a 
CXD-ref, DEFINE is invoked to initialize 
the V- and R-values before the reference 
can be used to modify PMD or text. Using 
the relocation modifier, MODFY now picks up 
the bytes of PMD or text, and adds or sub- 
tracts the V- value, or substitutes the R- 
value of the reference. The modified field 
is then returned to its original location. 
Only one page can be processed at a time so 
at the end of each page, MODFY returns to 
caller. 

Compute and Link Defs into Hash Chains 
(LINK) 

This subroutine computes the value of a 
DEF or a Q-ref and calls HASH to post the 
DEF or Q-ref on the appropriate TDY hash 
chains. On entry, LINK expects: 

• the CSECT address, 

• the corresponding CSD pointer, 

• the first DEF or Q-ref pointer, 

• the number of DEFs or Q-refs, and 

• an indication of the type of DEF (relo- 
cated, absolute, complex, or Q-ref) . 

LINK also sets up and maintains a hole 
table associated with the Q-ref value it 
calculates. 

On entry, the post indicator for HASH is 
set on. If the DEF is a user module, the 
double posting flag is set on for HASH. If 
this is not a Q-ref call, the V- and R- 
constants are increased by the CSECT base 
address, if necessary, the CSD link is set 
(for complex defs, the CSD link is set to 
Is at this time) , and HASH is called to 
post the DEF on the appropriate chains. 

If this is a Q-ref call, HASH is called 
to search to see if a Q-ref by this name 
has already been posted. If one has, HASH 
processes the Q-ref (see below) and the 



next Q-ref is examined. If no Q-ref with 
this name has already been posted, the 
attributes of the current Q-ref are 
examined to see if the Q-ref will fit in 
any of the holes, if there are any, in the 
Q-ref value table. If a fit is possible, 
the Q- value is placed in the Q-ref, the 
hole is marked filled, and HASH is called 
to post the Q-ref. 

If a new entry is needed, the next 
available location is adjusted to the prop- 
er boundary. If a hole is created, the 
value of the hole is placed in the hole 
table. A hole table entry is one word long 
and has the format: 



r T . T 

| length I boundary | Q- value 

l -L l 



The first byte contains the length of the 
hole; the second byte is the boundary value 
(X'Ol 1 = byte boundary, X , 02 i = half word 
boundary, X'O**' = fullword boundary, X'OS" 
= doubleword boundary) ; the last two bytes 
contains the Q-value of the start of the 
hole. 

The CXD value is updated by the attri- 
butes of the current Q-ref and HASH is 
called to post the Q-ref value on the Q-ref 
chain. 



Hash Routine (HASH) 

This is a subroutine used to post or to 
search for a definition in the TDY. On 
entry, the address of a REF or DEF, the 
address of the PMD preface, and the func- 
tion code are passed as parameters. A REF 
address and function code of are sent if 
the routine is to search, and a DEF address 
and function code of 1 are sent if the rou- 
tine is to post. If double posting is 
required, the high-order bit is set on. A 
ref address and function code of 2 is sent 
if it is a Q-ref call, with the high-order 
bit on for a queue search and off for a 
queue post. If the first half of a REF or 
DEF name is 0, the module sequence number, 
obtained from the PMD preface, replaces it. 
The name is hashed, and the hash value is 
multiplied by four. If the function is to 
post, the hash value is used to search for 
a search link in the hash chain based on 
the System Hash table. Once found, the 
address of the DEF is stored in the search 
link. If the chain is empty, the address 
of the DEF is stored in the hash table and 
the search link of the new DEF is zeroed. 
If double posting is required (that is, 
posting of the DEF on both the system non- 
privileged and user hash chains) , the user 
hash chain is then searched; if the chain 
is empty, the current DEF value is stored 
in the chain. If another DEF has been 
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posted with the same name as the DEF to be 
posted, an error message is issued. 

If the function is to search, the hash 
value is used to search for a definition in 
a hash chain based in the System Hash 
table. If the DEF is found, its address is 
returned in a parameter register; if not, a 
zero code is returned in the register. 

If the call is for a Q-ref , the hashed 
name is searched for on the Q-ref chain. 
If the name is not found, the Q-ref is 
posted either directly into or at the end 
of the Q-ref hash table chain. If the 
hashed name is found, the new Q-ref is 
posted at the end of the same hash chain. 
A test is made to see if the attributes of 
the two Q-ref s agree. If they do not, a 
diagnostic message is issued and the attri- 
butes of the first Q-ref are assumed. The 
value of the original Q-ref is given to the 
new Q-ref and control returns. 

If paging is needed while chaining a 
search or post, the first time through a 
minor paging buffer is allocated for the 
size of the major buffer. Each time paging 
is indicated, PAGTDY is called with a minor 
buffer indicator, ensuring that the CSD is 
in main storage but does not overlay the 
major buffer. 

Initialize Reference Entries in CSD 
(DEFINE) 



This subroutine is used to find the 
definition that resolves a reference, and 
to initialize the V-value, R-value, and CSD 
link of the reference. On entry, the 
address of the CSD (or PMD) of the 
reference, the address of the PMD preface 
and a pointer to the reference are passed 
as input. DEFINE invokes HASH to supply 
the address of the definition that resolves 
a reference. Once found, the V- and R- 
values and the CSD link of the definition 
are moved to the corresponding words of the 
reference. Should a noncomplex definition 
be undefined, a zero code is returned and a 
diagnostic message is issued. If a complex 
definition's CSD contains all ones, it is 
considered undefined and a diagnostic is 
issued for it. The V- and R- values of 
undefined references are set to all Is, and 
the CSD link is set to the address of the 
undefined reference's CSD. If a reference 
paired with a complex definition is defined 
by a complex definition, a warning is 
issued. The user count in the definition's 
CSD heading is incremented by one and con- 
trol is returned to the caller. 

Locate Name in TDY (NAMLOC) 



This subroutine searches the TDY for a 
given CSECT or entry point name and returns 
its address to the caller. The routine 



hashes the name supplied as an entry para- 
meter, searches for it in the corresponding 
hashing chain in the TDY, and returns its 
address. If the name cannot be found, a 
diagnostic message is issued and control is 
returned to the caller. 

Create TDY Storage Map (MAPGEN) 

This subroutine creates the Storage Map 
table in the TDY with entries in order of 
ascending CSECT base addresses. Every Con- 
trol Section Dictionary (CSD) in the TDY is 
located and the corresponding CSECT address 
is stored as an entry in the Storage Map 
table. These addresses are stored at the 
point where the CSECT address is greater 
than that of the preceding entry and less 
than that of the following entry. The 
CSECT address is stored in the first word 
of a doubleword entry, the CSD address in 
the second word. If a map is to be 
printed, main storage is obtained for 
building a temporary map. The start of the 
map is saved and the first word of each 
page points to the next page. The pointer 
on the last page is all ones. A temporary 
map entry contains the following informa- 
tion for each CSD in the TDY: 

• Pointer to the CSECT 

• Pointer to the CSD 

• Version ID (8 bytes) 

• Hierarchy number (1 byte) 

• Unused (3 bytes) 

A count is kept in the TDY heading of the 
number of Storage Map entries. Should the 
count exceed the maximum, an error message 
is issued and Startup terminates. Other- 
wise, control is returned to the caller. 

locate XPT or XSPT Origin (LOCXPT) 

This routine computes the origin of the 
External Page table or the Extended Shared 
Page table, which is aligned on a fullword 
boundary following the Page table or Shared 
Page table for the source segment. The 
calling program passes: an indicator as to 
whether or not the routine may need to cre- 
ate dummy entries, the number of pages in 
the segment, the type of page (regular or 
shared) , and the Page table origin. The 
end of the PT or SPT is calculated from the 
number of pages in the segment. If the 
number is even, the XPT or XSPT begins in 
the next location. If it is odd, a dummy 
entry is created. If the indicator speci- 
fies only the locate option, no dummy en- 
tries are created. The end of the XPT/XSPT 
is calculated from its number of pages, and 
again, if odd, a dummy may be created, 
depending upon the caller's option. LOCXPT 



40 



then returns to the caller with the start- 
ing address of the XPT or XSPT, and the 
address of the location following it. 

Form Page Table (FORMPT) 

This subroutine is called to create a 
Page table and External Page table entry 
for all pages of IVM in either a private or 
shared segment. For the priveite segment, 
the PT and XPT form a part of the XTSI and 
are written onto the paging drum. The 
Shared Page tables (SPT and XSPT) reside in 
real storage. Their addresses are stored 
in the Resident Shared Page Index table 
(RSPI) . 



or page boundaries according to the address 
in the storage map. Once the output buffer 
is ready, it is written on the paging drum 
for shared IVM and RSSSUP, on the paging 
disk for private IVM, or moved to a real 
storage location if RESSUP. 

When processing IVM pages, the external 
page number is stored in the XPT, if pri- 
vate, or in the XSPT, if shared. The ISA 
is the first page of IVM text to be 
processed. 

When processing RSSSUP pages, the 
external page number is stored in XPT2 of 
the RSS Communication table. 



On entry, an indicator is passed to 
FORMPT telling: whether the segment is 
private or shared, the number of pages in 
the segment, and the PT origin or XPT ori- 
gin. For each page in the given segment, 
the PT or XPT entry is set to unavailable, 
with a main storage address of 0. An XPT 
entry for the private segment, or an XSPT 
for the shared segment, is now created for 
each page. The entries contain certain bit 
settings : 

preferred paging device = drum 

type = program 

availability = assigned 

In a shared segment, the shared and auxil- 
iary flags are set on and the GQE pointer 
is set to in each XSPT entry. Control is 
returned to the caller. 

Load and Modify Text (GET EXT ) 

GETEXT is invoked three times by the 
Link- loader: once when processing IVM, 
once for RESSUP and once for RSSSUP. The 
routine reads the text pages from the IPL 
volume into an input buffer, modifies text 
according to information in the CSD for 
each module, packs it into the output buf- 
fer, and then moves it either into a pre- 
viously assigned storage location (RESSUP) 
or to the paging volumes (IVM or RSSSUP) . 

The TDY has previously been set up. The 
Storage Map in the TDY, containing the load 
address for each CSECT (or PSECT) and a 
pointer to the associated CSD, determines 
the loading order. Text is processed 
according to ascending CSECT base addresses 
in the storage map. The member descriptors 
in the POD are used to locate text pages on 
the IPL or Delta volume. If the member des- 
criptor cannot be found, a diagnostic mes- 
sage is issued and the entry is bypassed. 

After the text is read and, if neces- 
sary, modified in the input buffer, it is 
moved into the output buffer on doubleword 



Various tables are initialized before 
they are written on the paging volume. 
When CSECTs in the name lists (CSECTs 
referred to by later portions of Startup) 
are processed, the number of external pages 
used by them on the paging volume, and the 
addresses of their entries in the XSPT and 
XPT, are saved in the Startup communication 
region. 

As GETEXT processes RESSUP, the PSA 
modules are taken first. PSA modules are 
saved in a Startup buffer, and are not 
loaded for the initially-loaded CPU until 
later on in Startup. 

The SERR/Reconf iguration modules are 
written on all drums in the system, and are 
not loaded into main storage. They are the 
last modules to be processed. A provision 
is made for loading RESSUP text around 
unavailable main storage pages. Control is 
returned to the caller. 



Relocate TDY Entries (RELTDY) 



This subroutine is invoked to convert 
the Task Dictionary table entries from real 
storage addresses (RSAs) to virtual storage 
addresses (VSAs) . It is the first routine 
of two (the other being RELTAB/RELTBX) 
called to complete the conversion. 

RELTDY must first complete the Reloca- 
tion table (TDYTAB) . On entry the first 
two words of a three- word group (first RSA, 
last RSA) are complete. RELTDY must pro- 
vide the relocation factor to convert RSA 
to VSA, word 3. After the entire table is 
complete, two full words of ones are set 
following the last group. 

Next the input parameters are determined 
for each call to RELTAB/RELTBX. The rou- 
tine RELTAB or RELTBX performs the actual 
relocation on the following entries: 

1. Pointers in the system privileged, 
system nonprivileged, and user hash 
tables (RELTAB) . 
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3. 
**. 

5, 
6. 

7. 

8. 

9. 
10. 
11. 

12. 
13. 



Control Section Dictionary pointers in 
the TDY storage map IRELTAB) . 

PMD group headers (RELTAB) . 

Each Standard Entry Point (SEP) CSD 
link (RELTBX) . 

Each SEP search link (RELTBX) . 

PMD preface link to next PMD preface 
(RELTBX) . 

All SEP reference CSD links (RELTAB). 

Each PMD link in CSD heading (RELTBX). 

All Definition CSD links (RELTBX). 

All Reference CSD links (RELTBX) . 

TDY heading link to PMD group 
(RELTBX) . 

TDY heading pointers to System Hash 
Table, User Hash Table, and storage 
map (RELTAB) . 



Pointers in the dynamic loader Q- 
hash table (RELTAB) . 



ref 



If, during address conversion, RELTDY 
finds that conversion will cause private 
segment overflow, the three- word entry in 
TDYTAB containing pages in both segments is 
split into two three-word entries. The 
first three- word entry is for the end pages 
in the original segment. The second entry 
is for the first pages in the overflow seg- 
ment. Each entry in the TDYTAB corresponds 
to a section of the TDY which is located on 
contiguous pages in main storage. 

If paging has been done, the last entry 
will be contiguous virtual real storage 
addresses with the high-order bit on. 

Once control is returned from the 
RELTAB/RELTBX routine and the final 
addresses have been converted, control is 
returned to the caller. 

Relocation Table Processing (RELTAB, 
RELTBX) 

This subroutine is called by RELTDY to 
complete the conversion of RSAs to VSAs for 
the TDY. There are two entry points, 
RELTAB and RELTBX. Entry at RELTAB will 
relocate a series of TDY addresses, the 
number of which is furnished as a parame- 
ter. Also passed is a pointer to the first 
address to be processed, and a length 
value, indicating the increment to the 
first address to reach the second, and so 
on. Only one TDY address is processed by 
RELTBX and the address of that entry is 
passed as a parameter. 



The TDYTAB is a table of one or more 
three- word groups. If the TDY pages are 
loaded contiguously in main storage, there 
is only one group in TDYTAB. The first 
word of each group has the real address of 
the first page of the group, and the second 
word contains the real address of the last 
page of the group. The third word contains 
the logical relocation factor to be applied 
to each page within the group. There will 
be a group for every set of noncontiguous 
pages in the TDY. The end delimiter of 
TDYTAB is two full words of all Is. 

Processing of RELTBX and RELTAB is 
identical, except that RELTBX relocates 
only one page, while RELTAB relocates the 
number of pages it receives. 

The following steps are taken: 

1. The TDY RSA parameter is inspected. 

If 0, control goes to step 3; no relo- 
cation is necessary. If not 0, relo- 
cation is necessary and the first 
three- word group of TDYTAB is 
inspected to see if a match can be 
found within the group which corres- 
ponds to the RSA. There will always 
be at least one group in TDYTAB. If 
the address is within the group, con- 
trol passes to Step 2. If not, the 
next TDY entry is inspected until the 
right group is found. 

2. Once the proper TDYTAB group is 
located, the routine relocates the RSA 
by the value in the third word of the 
group, and the new value, now a VSA, 
is stored back into the TDY. 

3. If there are any more RSAs requiring 
relocation, control is sent back to 
step 1 and the processing repeated for 
all given RSAs. When all RSAs have 
been relocated, control returns to the 
RELTDY routine. 

Set External Page Number in XPT/XSPT 
(SETPT) 

This subroutine is called to set the 
corresponding external page number or head 
and slot number in the XPT or XSPT entry 
for a VMA. It is called whenever a page of 
text, previously assigned a virtual storage 
address, is written on an external page of 
the paging volume. The protection key for 
each page is set according to the value in 
the load list entry for the CSECT to which 
this page belongs. On entry, two Startup 
cells contain certain input information: 

STARTAD = virtual storage address. 
XPGNO = external page number. 

First, the segment number is determined 
from the virtual storage address. The 
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length of the segment and the starting 
address of the PT or SPT are used as param- 
eters to invoke the subroutine LOCXPT, 
which locates the starting address of the 
XPT or XSPT. When control is returned to 
SETPT f the entry of the page containing the 
virtual address is located by searching the 
XPT/XSPT entries arranged in ascending vir- 
tual address sequence. The external page 
number (disk) , or head and slot number 
(drum) f and protection key aire stored in 
the entry, and control is returned to the 
caller. 

If RSSSUP is being processed, entries 
are made in XPT2 of the RSS Communication 
table. The protection key is not set for 
RSS pages. 



Read Page From IPL Volume (READIN) 

This is the subroutine called to read a 
page of a data set from the IPL or Delta 
volume. It searches EXTAB for the extent 
containing the virtual page number which 
was supplied as a parameter. It calculates 
the corresponding external page number. If 
the virtual page number cannot be found in 
EXTAB, a diagnostic message is issued and 
READ IN sets an error code and returns to 
the caller. Otherwise, a subroutine is 
called to convert the external page number 
to a 2311 or 2314 CCHHR. The CCHHR is set 
in a CCW area to read a page into the 
Startup input buffer. READIN sends the 
address of the IPL or Delta volume to 
EIAA2, which builds and executes the chan- 
nel program, checks for I/O errors and 
returns. The caller's virtual page number 
is incremented by one, and control is 
returned to him. 

Delta Data Set Routine (DELDS, DELTBL, 
DELBTB) 

Chart AC, Pages 3 and 4 

This subroutine asks the operator (via 
OPER) if a Quickstart data set is to be 
built. The operator responds with the 
device address of the volume on which the 
Quickstart data set is to foe built. The 
response is checked to make sure that the 
volume specified is VAM2- formatted. If so, 
parameters are initialized to indicate to 
the Link-loader (EIAA5) that a Quickstart 
data set is to be created after link- 
loading IVM and RESSUP . 

DELDS then asks the operator or reads a 
card to determine if Delta data sets are to 
be loaded. If the system is not to be 
modified, the operator or card reply is ' N f 
and Startup proceeds to load Initial Virtu- 
al storage, the Resident Supervisor and the 
Resident Support System from the system 
data sets on the IPL volume. 



If the reply is f Y f , DELDS obtains buf- 
fers for reading in a Delta data set name 
list and for building a Delta data set name 
list. The address of the Delta volume and 
the Delta data set specification are supp- 
lied by the operator or by card input. If 
card input is used, cards are read until an 
end-of-file condition occurs or a card with 
END in columns 1-3 is encountered. Then 
DELDS checks to see that the device address 
is the proper length, and that the charac- 
ters in the data set specifications are 
valid. (The address of the Delta data set 
volume must be different from that of the 
IPL volume and the paging disk.) 



Next, DELDS obtains the volume label and 
PAT from the Delta data set volume. The 
DELTBL routine is invoked to build a table 
of Delta data set names. 



If the operator has specified 'ALL* as 
the data set specification, all appropri- 
ately qualified Delta data sets on the 
volume will be searched prior to the system 
data sets on the IPL volume. The list of 
names of data sets to be searched will be 
generated in the order in which they appear 
on the DSCB pages. 



If individual data set names were sup- 
plied (as the specification) , each is 
checked for the required format. If 
correct, each is entered into the IVM, 
RSSSUP or RESSUP list in the order speci- 
fied by the operator or by card input. 

If all data sets identified by a par- 
tially qualified data set name are to be 
searched in the order in which they are 
found on the volume, only the partially 
qualified data set name need be entered by 
the operator. If a specified Delta data 
set name does not appear among the DSCBs on 
the DSCB pages on the Delta data set 
volume, a diagnostic message is issued and 
the name is not entered in the list. If no 
DSCBs can be found (system or Delta) , com- 
prising Initial Virtual storage, the Resi- 
dent Supervisor, or the Resident Support 
System, Startup is terminated; otherwise 
Startup continues. If one or more Delta 
data set names are (explicitly or implicit- 
ly) specified more than once, a diagnostic 
message is issued, and only the first spe- 
cification is entered into the list. 

The system data sets TSS*****.SYSIVM, 
TSS*****. RESSUP, and TSS*****. RSSSUP are 
always placed last in the list. The DELTBL 
routine is invoked to make entries into the 
data set table (DSTBL) . As entries are 
made into the DSTBL, the external pages of 
that data set are entered into the extent 
table (EXTAB) via the EXTENT subroutine. 
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Initialize the XTSI and Page Table Pages 
(XTSIRT) 

The XTSIRT routine is called to create 
an External Task Status Index (XTSI) for 
the Main Operator's Task. First, the fixed 
format portion of the XTSI is initialized. 
This entails setting up the following 
fields : 



• the cold start PSW 

• estimated time 

• user time value 

• XTSI page count 



Next, the Segment table is initialized. 
This table begins on the first eight-word 
boundary following the fixed portion of the 
XTSI. The Segment table entry for segment 
is set to the relative origin of the Page 
table (PT) within the XTSI page. The Seg- 
ment table entry for the shared segments is 
initialized by the Shared Page Table 
routine. 

Now, the Auxiliary Segment table (AST) 
is initialized. The 'assigned 1 flags are 
set in the AST entries for segment and 
segment 1, indicating that these segments 
have already been allocated. 

Next, the Page table (PT) and External 
Page table (XPT) for segment (private) 
are constructed within the XTSI page. An 
even number of pages must exist within seg- 
ment 0. Dummy entries are created within 
the PT if an odd number of pages exist 
within segment 0. LOCXPT is called to lo- 
cate the origin of the XPT within the XTSI 
page. 

FORMPT is then called to create PT and 
XPT entries for segment 0. If there is an 
overflow private segment, it is determined 
whether or not its PT and XPT will fit in 
the original XTSI page. If they will fit, 
the PT and XPT are created in the same 
manner as for segment and the 'assigned" 
flag is set in the AST entry for that seg- 
ment. If the PT and XPT will not fit on 
the original XTSI page, a new Page table 
page is allocated and a pointer to this 
page is set in the XTSI. A flag is also 
set in the AST entry to indicate that the 
Page table for this segment is located on 
an overflow XTSI page. When the XTSI is 
paged out (the PGXTSI routine) , the extern- 
al location of the particular XTSI page 
containing the Page table for this segment 
is entered in the appropriate AST entry. 
When the first additional Page table page 
is allocated, the XTSI overflow flag is set 
on. 



The Page table page header is initial- 
ized next. For each additional Page table 
page that is allocated, forward and back- 
ward pointers are set and the count of the 
Page table pages in the XTSI is incremented 
by 1. 

Following the Page table page header, 
the PT and XPT is constructed. Each PT and 
XPT is preceded by a Page table header. 
The size of the Page table varies as a 
function of the number of pages within the 
segment which have been allocated. There- 
fore, the block size is set in the Page 
table header. The 'segment availability* 
flag is set to active. 

If there is more than one private over- 
flow segment, it is determined whether an 
additional PT and XPT can fit on the exist- 
ing Page table page. If it can, the count 
of the number of Page tables in the Page 
table page is incremented by 1. This 
field, which is located in the Page table 
page header, is initially set to 1 whenever 
a new Page table page is allocated. If an 
additional PT and XPT cannot fit on the 
existing Page table page, a new Page table 
page is allocated. The PT and XPT is then 
constructed for this segment. A pointer to 
this Page table page is set in the Segment 
table entry for this segment and the 
'assigned' flag is set in the AST. The 
segment number is stored in the header, for 
cross-referencing purposes. Pointers are 
established to keep track of available 
space on the Page table page. 

Control returns to Link-loader mainline. 

Initialize SPT and XSPT for Public Segments 
(SHPTRT) 

This routine locates and forms the 
Shared Page table (SPT) and External Shared 
Page table (XSPT) for each public segment. 
This is accomplished in the following 
manner . 

First, LOCXPT is invoked. The LOCXPT 
subroutine computes the origin of the XSPT 
and creates dummy Page table entries in the 
event that there are an odd number of pages 
in the segment. FORMPT is invoked next. 
The FORMPT subroutine creates External 
Shared Page table entries. All the Shared 
Page tables reside in main storage. 

For each additional overflow public seg- 
ment (if any), an additional page of main 
storage is allocated for the SPT and XSPT. 
The Segment table entry and AST entry are 
initialized for each overflow segment to 
reflect the length of the segment and the 
SPT number. In addition, the ' PT in main 
storage', "shared segment', and segment 
•assigned' flags are set in the AST for 
each overflow public segment. 
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The SPT and XSPT have now been created 
in buffers. These tables will be relocated 
later by the CRRSPI routine. 

Control now returns to Link-loader 
mainline. 

Write Task Dictionary Table (WRTDY) 

This routine writes the Task Dictionary 
table (TDY) out onto the paging disk. 
First, the TDY header and map are written. 
The unused pages of the TDY header are not 
written. Then, the TDY itself is written 
out. 

As each page is written, its external 
page number is entered in the appropriate 
XPT entry by the SETPT routine. 

Control returns to Link-loader mainline. 

Build RSS Communication Table (RCOMTB) 

The RCOMTB routine creates the RSS Com- 
munication table (RSSCOM). 

A virtual storage area is defined by its 
page tables. The RSS Communication table 
defines the virtual storage used by RSS. 
The Page tables define which external pages 
are mapped into each segment of virtual 
storage. RSSCOM resides in real storage 
following the last Resident Supervisor 
CSECT. RCOMTB decides whether or not 
RSSCOM will fit on the last Resident Super- 
visor page. If not, an additional page is 
allocated. 

RCOMTB creates Page tables PT2 and XPT2 
which are initialized with real storage and 
external storage addresses of the nonresi- 
dent portion of the RSSSUP data set. This 
Page table format is identical to that of 
the virtual storage Page table format of 
segment 2. RSS uses this format because 
the Dynamic Address Translation hardware is 
active during RSS execution. 

Additional Page tables are created in 
RSSCOM. PT3 and XPT3 are initialized with 
the address of the RESSUP/RSSSUP Symbol 
table. (This Symbol table resides on the 
paging drum as a portion of IVM. ) 

XPT 4 contains as many entries as the sum 
of entries in PT2 and PT3. The entries are 
the external addresses of the read-only 
portion of the Resident Supervisor which 
must be reloaded after the execution of 
RSS. 

When the nonresident portion of RSS is 
to be executed, it is loaded into the por- 
tion of real storage occupied by the read- 
only portion of the Residcmt Supervisor. 
RCOMTB determines whether there are enough 
pages in the read-only portion of the Resi- 



dent Supervisor for the nonresident portion 
of RSS. If there are not enough pages, RSS 
is responsible for allocating this room for 
the remainder of itself. 



To facilitate this during system 
startup. Startup fills as many PT2 and PT3 
addresses as it can. It passes this "Page 
Status" information to a resident RSS con- 
trol module. "Page Status" information is 
described as follows: 
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where 

n x = total number of Segment Two Page 
Table (PT2) entries required to 
page in the transient portion of 
RSS on a demand basis; 

n 2 = number of Segment Two Page 

addresses resolved by Startup 
(page addresses of the pageable 
portions of the Resident 
Supervisor) ; 

n 3 = total number of Segment Three Page 
Table (PT3) entries required to 
page in the Symbol Dictionary on a 
demand basis; 

n = number of Segment Three Page 
addresses resolved by Startup 
(remaining page addresses of the 
pageable portions of the Resident 
Supervisor. 

RSS then computes the number of real 
storage pages it needs from "Page Status" 
and pages the remainder of RSS into real 
storage. 

PTO contains a map of all real storage 
addresses from virtual page X'OO" to X'FF*. 
PT1 contains a map of all real storage 
addresses from virtual page X'lOO* to 
X'lFF' . 

A Segment table is initialized with en- 
tries for PTO, PT1, PT2, PT3, and PT4. 
Each entry contains the length and address 
of the respective page table. Control 
returns to link-loader mainline. 



Write RESSUP/RSSSUP Symbol Table (WRSYMTB) 

The Write Symbol table routine (WRSYMTB) 
writes the RESSUP/RSSSUP Symbol table on 
the paging drum. It records the external 
address in the XSPT and in XPT3 of the RSS 
Communication table. This table had pre- 
viously been built by SYSGEN. 
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Add Pages to Shared IVM (ADDPGS) 

ADDPGS adds new pages to shared IVM by 
expanding the last assigned SPT/XSPT. If 
not enough room exists in the last assigned 
SPT/XSPT, ADDPGS creates a new SPT/XSPT. 
The Segment table and Auxiliary Segment 
table entries for the public segment 
involved are updated. 

ADDPGS is called in order to add the 
RESSUP/RSSSUP Symbol table pages to shared 
IVM. 

Build Shared Data Set Table (BDSDST) 

The Build Shared Data Set table routine 
initializes the Shared Data Set table and 
sets up a member entry for the RSS Symbol 
table. This member entry is generated so 
that VSS may calculate the virtual storage 
address of the RSS Symbol table. Since the 
RSS Symbol table is placed into virtual 
storage following the link- loading of Ini- 
tial Virtual storage, it is not possible to 
resolve this address in the normal manner. 
(See FIXPMD routine for normal address 
resolution. ) 

The address of the RSS Communication 
table is computed by VSS from the Shared 
Page table number and the byte address 
relative to the beginning of the Shared 
Page table. 

The member entry for the RSS Symbol 
table (CHBRST) is located by referring to 
the hashing chain pointer which Startup 
initializes in the SDST header. A pointer 
to the SDST is placed in the ISA and the 
SDST is written on the paging drum. SETPT 
is called to initialize page table entries 
for the SDST. 



buffer, up to the first X'FF' entry, are 
read into the location specified in the re- 
cording buffer (QKRD80R) from the next 
location in the DSCB (QKRD90), and the 
RESSUP flag is set in the byte map. If 
there are any drums, the SERR/ 
Reconfiguration pages are also read in from 
the Quickstart volume and written on each 
drum in the system. 



The XTSI and page table page buffers are 
read back from their DSCB location (QKRD90) 
into the buffer location indicated in the 
Communication Region. 

The buffers are released, and control 
returns to offer the demounting of the IPL 
pack. 

QKRD80R — reads from the Quickstart IPL 
volume to a buffer. 

QKRD80W — writes a buffer. If the device 
type code in the recording buf- 
fer is X^O* (indicating 2301), 
it will write to the primary 
paging device. Otherwise, it 
will write to the secondary pag- 
ing device. 

QKRD90 — locates the next available rela- 
tive page number entry for the 
Quickstart data set. 

At any point, if an unrecoverable I/O error 
occurs, the message ERROR READING QUICK 
START DATA SET — QUICK START TERMINATED is 
issued to the operator and Quickstart ter- 
minates. Quickstart also terminates if 
reading in the Quickstart data set overlays 
the Page Allocation table on the secondary 
paging volume. 



QUICKSTART SUBROUTINES 

Read in Quickstart Data Set (QKREAD) 

QKREAD reserves pages for the buffers it 
needs, and then calls RDSCB to locate the 
Quickstart format- E DSCB on the IPL volume. 
The recording buffer pages are located 
within the DSCB, and all three are read in. 

For each entry in the recording buffer, 
up to the first entry of X f FF' , the next 
DSCB location is found (QKRD90), and the 
page is read from the Quickstart IPL volume 
(QKRD80R) and written to the primary or 
secondary paging device, as necessary 
(QKRD80W) . 

After IVM is brought back in, if the 
system is duplex or half duplex, QKREAD 
checks that the PSAs are in the same loca- 
tion, and the PSA buffer is read back in. 
The remainder of the pages in the recording 



Quickstart Data Set Creator (CEIAB) 

Chart AC, Page 8 

The Quickstart routine consists of a 
mainline routine that calls a number of 
independent subroutines with specific func- 
tions, and a set of common subroutines. 
Upon entry, the mainline (Chart AC, Pages 
8-10) sets up standard linkage and executes 
initializing steps. Quickstart then links 
to a routine (DSCBE) to create the forma t-E 
DSCB for the Quickstart data set (or to 
locate the DSCB if the data set already 
exists). Quickstart then calls subroutine 
DSC3 to locate and update the DSCB entry 
to reserve three pages for the recording 
buffers. DSC30 is called again to locate 
and reserve pages for Startup and the CCB, 
and DSC60 is called to write out the CCB 
pages. The number of Startup pages and the 
number of CCB pages is recorded in the re- 
cording buffer. 
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Link- edited IVM is then written on the 
Quicks tart volume, beginning immediately 
after the CCB. For each assigned segment, 
the external page table (XPT) , or the 
external shared page table (XSPT) is 
located in main storage; the PAGRT subrou- 
tine is called to write all pages in that 
segment onto the Quickstart data set. RSS 
page tables are then written as a part of 
IVM. Upon completion of IVM a word of 
X f FF' is put in the recording buffer. 

The PSA buffer (or the page buffer in 
a simplex configuration) is next written on 
the Quickstart volume, and the address of 
the PSA is placed in the recording buffer. 
In a duplex system, the address of the 
other CPU's PSA is also placed in the re- 
cording buffer. 

By use of the byte map table (MEMAD) 
used by Startup, all pages that are 
assigned to RESSUP and RSSSUP (that is, all 
pages with X' DC* in this byte) are written 
on the Quickstart volume, and the addresses 
of these pages are placed in the recording 
buffer. Once RESSUP has been written, a 
one-word entry of X f FF" is made in the re- 
cording buffer. 

The XTSI and all assigned page table 
buffers are then written on the Quickstart 
volume and their addresses are placed in 
the Communication Region of Startup. 

The recording buffer itself is then 
written in the Quickstart data set in the 
pages reserved for it. The last DSCB is 
closed out. If there are excess pages in 
the Quickstart data set from a previous 
Quickstart data set creation, these pages 
are then freed. The DSCB buffer and the 
PAT for the Quickstart volume are written 
in the Quickstart data set. 

Startup is then located and written on 
the Quickstart volume on the pages pre- 
viously reserved for it. 

Write IVM Page (PAGRT) 

Chart AC, Page 11 

This subroutine writes pages from an 
external page table or from an external 
shared page table onto the Quickstart 
volume. For each nonzero esntry in the XPT 
or the XSPT for a given segment, PAGRT 
reads that relative page number off the 
primary or secondary paging device. The 
relative page number is obtained from the 
XPT or XSPT entry. For a drum, the slot/ 
page format is first converted to a rela- 
tive page number format, and Startup sub- 
routine EIAA2 is called to perform the READ 
into the Read/Write buffer. This buffer is 
then written on the next available page of 
the Quickstart data set. The device-type 



code of the direct access device for the 
current segment, and the relative page 
number of that device, are recorded in the 
recording buffer entry (public segments are 
written to a drum if one exists). 

The PAGRT subroutine is called once for 
each assigned segment in IVM. 

Create Forroat-E DSCB (DSCBE) 

Chart AC, Page 12 

This subroutine creates a format-E DSCB 
for the Quickstart data set, or locates a 
previous one on the Quickstart volume. 

DSCB first calls GETPAT, a Startup sub- 
routine, to read the DSCB pages on the 
Quickstart volume. Each DSCB is searched 
for the identifier TSS*****.QKSTART; if 
this is found, the relative page number and 
the slot number are saved and return is 
made to the mainline. If no format-E DSCB 
is located by the PATLOC subroutine, a new 
DSCB page is located (by calling PATLOC) 
and its relative page number is saved. 
Slot is marked as the slot number for the 
format-E DSCB. Fixed format-E information 
(the identifier TSS*****.QKSTART concate- 
nated with .DSxxxxxx, where xxxxxx is the 
volume identification of the Quickstart 
volume) is then moved in. VAM-sequential 
and fixed- length flags are set, and the 
record length is set to 4096 bytes, as is 
the field containing the number of bytes on 
the last page. The format-E indicator is 
set and control is returned to the mainline. 

Locate DSCB Word/Free Page (DSCBF/DSCBA) 

Chart AC, Page 13 

If entry is at DSCBF, this subroutine 
locates the next available word in the 
DSCB. If entry is at DSCBA, the subroutine 
frees all remaining pages in the Quickstart 
data set. 

If there is more room in the current 
DSCB, the displacement is updated, the 
location is calculated by displacement into 
the DSCB buffer and, if pages are not being 
freed, the number of pages in the data set 
is updated by one and control is returned 
to the mainline. 

If pages are being freed (entry was at 
DSCBA) the next relative page number, if it 
exists, has its entry freed in the PAT 
table, the entry is freed in the DSCB, the 
number of pages freed is updated, and 
transfer is made to see if the next dis- 
placement is in the current DSCB. When 
there are no more pages, the DSCB type is 
set in the E-format DSCB, the Checksum 
value is calculated, and control returns to 
the mainline. 
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If the current DSCB is full, a check is 
made to determine if the Quickstart data 
set previously existed, or if entry was to 
free pages. If neither is true and it is 
not a format- E DSCB, the format- F indicator 
is set, and a check is made to see if 
another DSCB can fit on the page. The new 
slot number is saved internally, as well as 
in the forward pointer of the previous 
DSCB, along with the relative page number 
for the DSCB page. The Checksum value is 
calculated, and, if a new page has not been 
started, the displacement is set to zero 
and the location of this DSCB within the 
buffer is calculated in preparation for an 
exit. If entry was to free a page, on the 
first time through, the type is set in the 
DSCB and control branches to calculate the 
Checksum value. 

If this is not the first time through, 
the type and Checksum are changed to zeros , 
and control branches to check if the new 
DSCB page is the same as the old. 

If there are no more DSCB pages on the 
chain, and if a page is not being freed, 
the exist flag is turned off in the Quick- 
start byte, the new-data-set-larger flag is 
turned on, and control branches to get a 
new DSCB page. If a page is being freed, 
all other pages have been freed and the 
subroutine exits to the mainline. 



Locate Available Page (PATLOC) 

This subroutine locates an available 
page on the Quickstart volume by searching 
the PAT for an indicator of X^O*. If the 
end of the PAT is reached, the message 
INSUFFICIENT SPACE ON QUICKSTART VOLUME - 
QUICK START CREATOR ABORTED is sent to the 
operator and control returns to Startup. 
Otherwise, the relative page number of the 
page just located and a pointer to its PAT 
entry are returned. 

Update Buffer Location (RECPG) 

This routine updates the address of the 
next available location in the recording 
buffer. If a buffer page is full, a check 
is made to see if it was the last recording 
page. If it was not, the current buffer is 
written out again, the current buffer 
address is updated, the next available 
location pointer is reset and control 
returns to the mainline. If no new page is 
needed, just the pointer is updated. If 
the last page was just filled up, the 
message 

RECORDING BUFFER FULL 
QUICKSTART CREATOR ABORTED 

is sent to the operator and control returns 
to the Startup module. 



Buffer Cleanup (DSC20) 

This subroutine clears out the contents 
of a buffer. 

XSPT Entry Convertor (DSC25) 

This subroutine converts the XSPT entry 
of a drum from slot/record format to rela- 
tive page number format. 

Read from Quickstart Volume (DSC50) 

This subroutine reads from the Quick- 
start volume into a buffer. If an unrecov- 
erable I/O error occurs, a message is sent 
to the operator: 

I/O ERROR CREATING QUICKSTART DATA SET 
QUICKSTART CREATOR ABORTED 

and control returns to the mainline. 

Write to Quickstart Volume (DSC60) 

This subroutine writes the contents of a 
buffer onto the Quickstart volume. If an 
unrecoverable I/O error occurs, a message 
is sent to the operator: 

I/O ERROR CREATING QUICKSTART DATA SET 
QUICKSTART CREATOR ABORTED 

and control returns to mainline. 

Calculate Checksum (DSC75) 

This subroutine calculates the Checksum 
of a DSCB and stores it in the previous 
DSCB. 

Error Exit (ERREXA) 



This is the routine given control when 
an error occurs. A message is issued to 
the operator indicating the type of error 
encountered. If the Quickstart data set 
already existed or if the PAT had already 
been written, the pages are freed and only 
the format-E DSCB indicator remains. 
Otherwise, no indication is made and con- 
trol returns to Startup. On a recursive 
call to the error routine, a message is 
issued to the operator: 

CATASTROPHIC ERROR ENCOUNTERED - QUICK- 
START CREATOR TERMINATED 

and CEIAB terminates. 

COMMON STARTUP SUBROUTINES 

Read/Write Operator Routine COPER) 

This routine is called to issue a 
desired message and accept a reply, if 
requested. On entry, a general register 
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contains the number of the message to be 
issued. On the first pass, OPER relocates 
all address constants in the message 
address table. Then the parameter message 
number is used to index into the table, to 
obtain the length and address of the appro- 
priate message. Another parameter register 
indicates one of the options (write-only, 
read-only, or read/write) , and if appli- 
cable, the length of the read. STERM is 
invoked to do the actual I/O on the opera- 
tor" s terminal. Control returns to the 
caller. 

Read Cards Routine (READCARD) 



This routine is called whem operator 
response messages are to be entered as card 
input and not through the operator ' s ter- 
minal. If a card is read successfully, it 
is printed at the operator's terminal (via 
OPER) and control is returned to the caller 
with register 1 pointing to the address of 
the card buffer. If an end-of-file occurs, 
zeros are returned in register 1. 

Print Message Routine (PRINTER) 

This routine is called to print a mes- 
sage on the printer, and, if the message 
corresponds to a major error, to print the 
message on the operator's terminal and ter- 
minate Startup. Parameter registers speci- 
fy the message number and the severity of 
the error. PRINTER calls EIAA2 to send the 
message to the printer. Normally, control 
is now returned to the caller. However, if 
a major error occurs, PRINTER invokes OPER 
to issue the same message to the operator's 
terminal, and then enters the wait state. 

Get Field Routine (GETFLD) 



This routine is called to locate a 
desired field within a given area. (A 
field is defined as a group of characters 
within two delimiters. The delimiters 
include the beginning and end of the area, 
a comma, a tab character, (x'15*), and a 
string of one or more blanks.) GETFLD 
scans through the area until the given 
field is located and then returns the 
length and address of the field. If the 
field is not found, the length is set to 0. 
The address is set to -1 if the end of the 
given area was reached before the desired 
field, or to if the field contained no 
information. 

Operator's Terminal I/O Subroutine (STERM) 

This is a subroutine called by Startup 
routines when a message must be printed on 
the operator's terminal. Its purpose is to 
initiate and control any communications 
between Startup and the system operator. 
On entry, parameter registers contain eith- 
er the address of a CCW list, or data to be 



inserted into a prestructured CCW. This is 
determined by checking the high order byte 
of the first parameter register. If non- 
zero, the prestructured CCW is used; other- 
wise the address of the CCW list is set in 
the CAW. I/O processes are initiated via 
an SIO, and comprehensive error checks are 
undertaken to insure the successful initia- 
tion and completion of all the I/O steps. 
If the communication fails after ten re- 
tries, a message is issued on the printer. 
Should there be any malfunction with print- 
er I/O, this process is tried again 10 
times. In any event, this subroutine ter- 
minates Startup whenever the system opera- 
tor' s terminal cannot be reached. On a 
normal exit, at successful completion, 
registers are restored and control returned 
to the caller. 



Move Text (MVTEXT) 



This subroutine moves bytes of text from 
one location to another. In general it 
moves information from an input buffer to 
the output buffer. Entry parameters con- 
sist of the number of bytes to be moved 
(specified in INAD) , and the address of 
their destination (specified in OUTAD) . 
Bytes are moved in blocks of 256 and are 
moved in ascending sequence by location, 
beginning at INAD. Should the last move 
require less than 256 bytes, only the actu- 
al number of bytes remaining in the block 
are moved. Control is returned to the 
caller at the completion of the move. 



Write Page on Paging Volume (OUTPG) 

This subroutine writes a page from the 
output buffer onto either the paging disk 
or the paging drum. Two cells are set up 
in main storage before entry to OUTPG takes 
place, XPGNDK for the disk (the primary 
paging volume) and XPGNDR for the drum (the 
secondary paging volume) . XPGNO contains 
the external page number on the paging 
volume where the output buffer page is 
written. PAGAD contains the device and 
hardware address type of the primary paging 
volume and SPGAD contains the device type 
and the hardware address type of the secon- 
dary paging volume. After determining the 
device type, OUTPG branches to ATRAN for a 
2311 disk, to CTRAN for a 2314 disk, or to 
BTRAN for a 2301 drum. These routines con- 
vert the external page number to its corre- 
sponding CCHHR. Then, having set entry pa- 
rameters for it, OUTPG calls EIAA2 to 
execute the CCW list for writing the output 
buffer on this CCHHR of the paging volume. 
If an I/O error occurs, OUTPG increments 
the external page number by one and retries 
the whole process. Once the attempt is 
successful, the output buffer is zeroed and 
control returns to the caller. 
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Create Symbol Table (SYMGEN) and Print 
Storage Map (SORDID) 

This subroutine is called to create a 
table containing names and values of 
CSECTs, and their entry points in Initial 
Virtual storage or RESSUP/RSSSUP. The user 
is given the option of requesting a printed 
map of either Initial Virtual storage and/ 
or the Resident Supervisor. If a map is to 
be printed, storage temporarily allocated 
for the map in MAPGEN is released and SOR- 
DID is called. SORDID sorts the CSECT 
names both alphabetically and numerically. 
The CSECT names, their respective real or 
virtual addresses, the version IDs and 
hierarchy numbers are arranged in ascending 
sequence within three columns. These names 
and values are printed in the form of a 
storage map, a page at a time, on the 
printer. Whether or not printing of the 
storage map is requested, linkage is pro- 
vided to the RESSUP/RSSSUP Symbol table for 
RSS/VSS. 



The symbols and their addresses are 
located for both data sets in the temporary 
map created by MAPGEN. The number of en- 
tries is found in the TDY heading and the 
origin of the table is in a field called 
JSMPBG. Each entry points to a CSD. A 
24-byte entry is created for each defini- 
tion in the CSD; an 8-byte left-adjusted 
name, a 4-byte value field, an 8-byte ver- 
sion ID, a 3-byte hierarchy number and an 
unused byte. The version ID is either an 
8-byte name specified by the creator of the 
CSECT or a binary coded time stamp. The 
high order bit of the version ID is tested, 
and if it is off, the version ID is con- 
verted to the form: mm/dd/yy hh:mm:ss. 
Entries are made alphabetically. If the 
number of potential entries exceeds the 
buffer space allowed, a diagnostic message 
is issued but the subroutine is not ter- 
minated. A heading is added to the symbol 
table identifying the storage map. The 
symbol table is printed in hexadecimal 
pri nt char act ers . 



The buffer space for RESSUP 's storage 
map is a fixed size of one and a half 
pages. IVM's buffer size is determined 
dynamically. The following are considera- 
tions for the RESSUP/RSSSUP Symbol table 
only: 

• A combined symbol table of RESSUP/ 
RSSSUP is created for the use of RSS/ 
VSS. This symbol table is later writ- 
ten on the primary paging device by the 
Write Symbol Table (WRSYMTB) routine. 

• SERR/Reconf iguration modules are 
bypassed. At the conclusion of SYMGEN, 
control is returned to the caller. 



Reserve Space for PMDs in TDY (ADDPMD) 

This subroutine is called to allocate 
storage for PMDs in the TDY, and initialize 
the PMD preface. The size of the PMD being 
processed is obtained from the user data 
following the module's member descriptor 
entry in the POD. For Initial Virtual 
storage, the first PMD is loaded eight 
pages above the TDY origin; for RESSUP, two 
pages. If enough space remains in a page, 
a second PMD is also assigned to it. If 
not, the PMD is assigned the next higher 
available page. If paging is needed, the 
initial major buffer and the buffer for 
BLDTBL are allocated at this time. All 
addresses allocated from this point on will 
be virtual real storage, indicated by the 
high-order bit being on. Space for PMDs 
can be allocated around malfunctioning 
pages. The table TDYTAB is used by IVM for 
relocating the TDY around these pages. The 
routine initializes only the first two 
words in any three-word group in TDYTAB. 
These words correspond to the lowest and 
highest real storage addresses within each 
contiguous group of TDY pages. The third 
word of a TDYTAB group is the common relo- 
cation factor. 

After the first PMD in a group is allo- 
cated, the group header is initialized. 
Each new group is linked to the TDY heading 
and to its preceding group. Once paging 
begins, if a new group is needed, BLDTBL is 
called to enter this table into the page 
table and to page it out. At this time, if 
the old buffer was not large enough for the 
new PMD, ADDPMD will get a larger buffer 
and a new minor buffer if it has previously 
been needed. The first group's pointer to 
the preceding group is set to 0. The TDY 
heading is updated to point to each new 
group, and within each group header the 
fields pointing to 'last PMD in group* and 
'end of group' are updated. After each PMD 
is allocated, the PMD preface link to the 
next PMD preface is initialized, and the 
remainder of the preface is zeroed out. As 
control is returned to the caller, the 
address of the PMD preface is sent as an 
exit parameter. 



Generalized Input/Output Subroutine (EIAA2) 

This is a subroutine used to initiate 
and control the I/O activity between the 
CPU and the channels. It is used to gain 
access to the direct access devices and the 
printer. On entry, the address of the I/O 
device is set in parameter register 1. A 
field called IOBYT is used to inform EIAA2 
of the options desired by the calling rou- 
tine. These options indicate: 

• Whether the calling routine has sup- 
plied a CCW list 
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• Whether a read or write operation is 
desired 

• Whether relocation is desired for disks 
if the first try is unsuccessful and 
the PAT indicates that there is a relo- 
cation entry for this external page 

If EIAA2 is to build the CCW list, the 
calling routine must specify pertinent 
information in the following fields: 

• IOLEN The number of data bytes to 

transfer 

• IOAD The beginning location of the 

transfer area 



function, control is returned to the caller 
via the return register. Depending on the 
calling routine, the activity requested, 
and the results of EIAA2, the appropriate 
return code is set in IOBYT and control 
returns to the calling routine. 



Write SERR/Reconfiguration Modules on Drums 
(SERR100, SERREND) 

This subroutine is invoked to write all 
SERR and Reconfiguration modules on all the 
drums in the system. On entry, the follow- 
ing fields of information are available to 
the routine: 



The CAW is then set up, and an SIO 
instruction is issued to the I/O device. 
Continuous comprehensive error checks are 
made to insure successful completion of the 
I/O activity. If a malfunction occurs, 
successive retries are attempted in order 
to complete the operation. Unrecoverable 
hardware errors result in a diagnostic mes- 
sage being issued to the system operator. 
The message informs him of the malfunction- 
ing device, and either CSW status bytes or 
sense bytes are displayed, depending on the 
nature of the failure. EIAA2 must also 
determine if it is necessary to terminate 
Startup. It terminates if the IPL volume 
is in use when the failure occurs, or when 
the paging volume malfunctions during the 
initialization of SDAT. 

If a track condition check occurs on an 
I/O operation to a disk, IOBYT is checked 
to see whether the relocation flag is set. 
If it is, the relocation control entry in 
the volume's PAT is checked to see whether 
there are any relocation entries. If there 
are, and if one of these entries is for the 
page in question, EIAA2 retries the opera- 
tion on the relocated page. These reloca- 
tion entries are set by the RESTORE program 
when it encounters a track condition check. 

If a command reject and a. seek check 
occur when using the paging disk, it is 
concluded that this disk is not VAM2- 
formatted. An appropriate message is sent 
to the operator and Startup terminates. 

Startup continues in all other cases. 
If there should be a recoverable error 
(form checks, dropping ready status, etc.), 
this routine issues a message to the opera- 
tor telling him of the problem and asking 
him to reply when the situation has been 
rectified. Startup waits for the reply. 
If a nonrecoverable error occurs on the 
printer, maintenance is required. This 
routine automatically switches to another 
printer if one is available. If not. 
Startup continues with printing suppressed. 
Once the I/O routine has fulfilled its 



XPGNO First available page on 
paging drum. 

PGSRSDA Table of drum hardware 
addresses. 

NODMSYS Number of available drums. 

OUPTAD Output buffer address. 

The GETEXT routine processes the SERR/ 
Reconfiguration modules last. It calls 
SERR100 to write each module on all the 
drums in the system. Each call results in 
one module being written on every drum. 
The module is in the output buffer when the 
SERR100 routine is entered. It writes the 
first SERR module on the paging drum, and 
stores the BBCCHHR of that module in the 
System table. This same address is then 
used as the starting location for the SERR/ 
Reconfiguration modules on each drum in the 
system. The external page number of the 
module just written is stored in the first 
half of a fullword entry for each drum in 
the list. This list is used later by the 
ASATRT routine. When a Reconfiguration 
module is written on the paging drum, its 
BBCCHHR is saved in the System table. 
Since it is possible that an I/O failure 
could occur when trying to write on the 
drum, it could happen that, though the 
first external page numbers of the modules 
are the same, the address of the last 
module could vary from drum to drum. 
SERR100 will skip any malfunctioning pages 
and write in the next available one. SER- 
REND is invoked by GETEXT to store the 
external page number of the last module 
written on each drum. This is saved in the 
second half of the entry for each drum in 
ASATRT' s list. Control returns to the 
caller. 



Get a Block of Main Storage (GETMEM) 

This subroutine is called to allocate a 
block of available storage. At entry, 
these parameter fields have been set: 
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GTDRN Direction of search for next 

page, if requested page(s) are 
not available. 



GTFLG Flag to be placed in page map. 

GTNUM Number of requested contiguous 
pa ges . 



GTNCA 



Test byte for termination. 



RTSTRT Starting address of assigned 
block. 

GETMEM is the routine called upon by the 
Startup routines whenever they wish for 
main storage allocation or wish to inspect 
the availability of a block of main 
storage. Each byte within the page map 
reflects the condition of its corresponding 
page of main storage. The byte settings 
and their meanings can be found in the 
SCBTL routine description. The search com- 
mences at the beginning of the map if GTDRN 
equals GTDUP, or at the end of the map if 
GTDRN equals GTDDOWN. The search continues 
in the specified direction until the 
requested block of contiguous pages is 
located. The value in GTFLG is then 
inserted in the bytes corresponding to the 
available pages, and the starting address 
of the block is returned to the caller in 
RTSTRT . 

If the requested block is not available, 
GTNCA is inspected. If the field is set to 
GTNCAR, control is returned to the caller 
with RTSTRT set to 0, indicating that the 
block of storage was unavailable and not 
allocated. If GTNCA is set to GTNCAT and 
the block was unavailable, GETMEM issues a 
diagnostic message to the operator indicat- 
ing that Startup must be terminated. The 
system then goes into the wait state. 

If GTNCA is set to GTNCARNF, and GTDRN 
equals GTDUP, only the first block follow- 
ing the last assigned block is searched for 
availability. If this block is available, 
the requested flags are set and the start- 
ing address is returned to the caller in 
RTSTRT. If the first block is not avail- 
able, control returns immediately to the 
caller with RTSTRT set to zero. This fea- 
ture enables real storage modules to be 
packed into contiguous pages. 



Create the Resident Shared Page Index Table 
(CRRSPI) 

This routine creates the Resident Shared 
Page Index table (RSPI) after RESSUP text 
has been loaded in main storage. It also 
obtains main storage for each SPT and XSPT 
and moves the tables from their buffers 
into lower main storage. 



The RSPI contains information regarding 
the origin and length of each SPT. Space 
for the RSPI is allocated on the last page 
of the Resident Supervisor if there is suf- 
ficient room. Otherwise, a new Resident 
Supervisor page is allocated for the RSPI. 

Three items are initialized in the Sys- 
tem table (CHBSYS) . 

• The pointer to the RSPI 

• The RSPI count 

• The next available SPT number 

Supervisor Core Allocation is called to 
reserve main storage for each SPT and XSPT. 
The SPT number, length and origin are then 
stored in the RSPI entry corresponding to 
the segment number in which they are to be 
located. Then the SPT and XSPT is moved to 
the storage location that has been reserved 
for it. The • reserved for RESSUP' flag is 
set in the Core Block table (CHBCBT) for 
each SPT page. 

Control returns to Startup mainline. 

Read Data Set Control Block (RDSCB) 

RDSCB is a generalized routine used to 
find a DSCB on a VAM2-f ormatted pack. Two 
options are provided. The first option 
supplies the DSCB when given the external 
page number of the DSCB and the slot number 
of the DSCB within the page as input. The 
second option supplies the DSCB when given 
the data set name. 

For the first option, the field DSNAD 
contains the address of the slot number and 
external page number as input parameters. 
For the second option DSNAD contains the 
address of the data set name. 

On entry, general register contains a 
1 if option one is desired or the length of 
the data set name if option two is desired. 
General register 1 contains the device 
address on which the data set resides. 

If option one is specified, RDSCB reads 
in the specified DSCB page if it is not 
already in main storage. The requested 
DSCB is then moved into DSCBF. 

On a normal return, the field DSCBF will 
contain the requested DSCB. General 
register will contain a 1 in its high 
order bit if the DSCB was not found. 

If option two is specified, a check is 
made to see whether a DSCB page for this 
volume is presently in main storage. If it 
is, each DSCB on this page is checked for 
the requested name until a match is found. 
If no match is found or if there is no page 
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in main storage, the PAT is checked for all 
DSCB pages on this volume- These pages are 
searched sequentially until either the DSCB 
is located or there are no more DSCB pages. 

Read Page Assignment Table (GETPAT) 

GETPAT searches the PAT table for a 
volume and returns the external page number 
of a given relative DSCB pag€i. The calling 
routine must supply the relative DSCB page 
number. (The first relative DSCB page is 
zero.) General register contains the 
relative DSCB page number and general 
register 1 contains the address of the 
device on which the DSCB page resides. 

On a normal return, GETPAT supplies the 
requested external page number in page 0. 
If the given relative page does not exist, 
the high order bit of general register is 
set to one. 

NIPLPAT contains the address of the PAT 
pages for this volume. DSCBF contains the 
volume label if this was the first call for 
this volume. 

The PAT for the IPL volume was read in 
by PRELUDE in order to locate the Startup 
DSCB and is therefore resident in main 
storage. If the requested volume is not 
the IPL volume or the volume specified on 
the previous call, the PAT is read in. The 
address of this volume and the length of 
its PAT is saved for the next call. (The 
PAT is one page long in the case of a 2311 
volume and two pages in length for a 2314 
volume. ) 

The PAT is then searched for the 
requested relative DSCB page. When the 
DSCB page is located, its external page 
number is computed from the displacement of 
the qualifying byte within the PAT. 

Page Task Dictionary Table (PAGTDY) 

This routine is called throughout the 
link loader, whenever a virtual real 



storage address is encountered. At entry, 
general register must contain a or 4 to 
indicate which of two buffers is to be 
used. REQAD1 or REQAD2 contains the virtu- 
al real main storage address requested. 
BLDTBL is called to write out the group 
currently in the buffer. The PMD group 
containing the virtual real storage address 
is then read into the buffer. RETAD1 
(RETAD2) is set with the real storage 
address which points to the virtual real 
storage address requested. 



Build Task Dictionary Table (BLDTBL) 

This subroutine is called by ADDPMD to 
write PMD groups that roust be paged onto 
external storage. Space is temporarily 
allocated by BLDTBL on the primary paging 
volume, starting with the highest external 
page number and decending to the lowest. 
This allocation is done on the assumption 
that space permanently assigned by Startup 
on that device will begin with the lowest 
available page number and work up. BLDTBL 
also builds a table containing information 
to permit retrieval of these PMD groups. 



For each page, there is an entry in the 
table, consisting of four words: 



1. displacement of page relative to 
beginning of TDY 



2. number of pages in group 



3. external page number 



4. displacement of this group relative to 
beginning of TDY 

BLDTBL may also be called by PAGTDY to up- 
date the external images of PMD groups pre- 
viously written out. 
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SECTION 4: SYSGEN PHASE 



Entry to the SYSGEN phase begins after a 
time sharing system has been generated, and 
a system programmer has logged on and 
assembled the system generation macro 
instructions. These macro instructions are 
an input data set for the TSS assembler. 
The operands of the macro instructions take 
the form of configuration- dependent parame- 
ters and installation option indicators. 
There are thirteen macro instructions in 
SYSGEN. Twelve of them may be assembled in 
any order. The thirteenth, GENSCB, must be 
last. They must be processed by the TSS/ 
360 assembler, and their output creates the 
SYSGEN. MODULE data set. The first twelve 
macro instructions create no code. They 
use input supplied by the systems program- 
mer to equate global symbols to configura- 
tion options. These global symbols are 
then used by GENSCB to fill in the system 
tables. Refer to Appendixes A and B for 
chart descriptions of the fields affected, 
and the global settings. 

Figure 6 gives an overall view of the 
following macros: 

CPU saves the identity of the CPUs, 
their model numbers, features and the 
primary and alternate prefixes assigned 
to each. 

STEM saves the number of storage ele- 
ments in the installation and their 
model number. 

CCU saves the number of channel control- 
lers in the installation. 

CHANNEL determines whether selector or 
multiplexor channels are present, and 
saves the hexadecimal address of those 
in existence. It also supplies a total 
count of both. 

DCU saves the addresses and IDs of all 
the control units in the installation. 
It also saves their model and unit 
numbers. 

DEVGRP saves the symbolic and actual 
addresses, the paths, units and model 
numbers of all the devices in the sys- 
tem. It also supplies various I/O 
parameters. 

OPCNSL saves the addresses and paths to 
the operator consoles. 



f ASSEMBLE J 



CPU 



save prefixes 
count of CPU's 



STEM 



save number 
storage elems 



CCU 



save number 

channel 

controllers 



CHANNEL 



save addr's 
MPX and SEL 
channels 



DCU 



save addr's, 
ID's of 
Control units 



DEVGRP 



save I/O 

device 

information 
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O 



OPCNSL 



save number/ 
addr's of 
oper. console 



save CL default 
options 



DISPAR 



save 

dispatching 

options 



TSKLMT 



save system 
task limits 
by type 



VMPAR 



save Vfvl 

allocation 

options 



PUBVOL 



save maximum 
number of 
public 
volumes 



GENSCB 



set up all 
system control 
blocks 



( END ) 



CLOP saves the command language default 
options. 



Figure 6. SYSGEN Macro Logic Flow 
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DISPAR saves the dispatching or schedul- 
ing options of the system. 



TSKL^T saves the system limits on size 
and number of tasks (specified by type) 
allowed to operate at any one time. 



VMPAR saves the virtual storage options 
that specify the parameters for handling 
and allocating virtual storage. 

PUB VOL saves the maximum number of pub- 
lic volumes. 

In all the above macro instructions, 
checks are made that valid information has 
been supplied. In conversational mode f a 
diagnostic message is issued on the termin- 
al. The Assembler waits for corrected 
information. In nonconversational mode, a 
diagnostic message is issued on the output 
device, but processing continues through 
GENSCB with possible erroneous results. If 
any errors are encountered in GENSCB, the 
entire macro processing must be done over 
again. 

GENSCB uses information supplied in the 
form of global symbols, and fills in the 
system tables. This macro generates code 
in the form of CSECTs . Chart AE presents 
the flow of GENSCB. First, all the global 
and local symbols are defined. The System 
table (CHBSYS) and the System Common table 
(CHBSCM) are generated using data from DIS- 
PAR, VMPAR, TSKLMT, and CLOP. Then the 
Scan table (CHBSCN) and Scan Master Control 
table (CHBSMC) are generated. Looping 
through a channel matrix, the Channel 
tables (CHBCHL, CHBMCH, and CHBSCH) are 
generated. Then, looping on channel con- 
trol unit addresses, the Control Unit table 
(CHBCUT) and its flags are set. Using a 
control unit and channel matrix, the Device 
Group tables (CHBDEV) are generated along 
with a Symbolic to Actual Conversion table 
(CHBSAC). The Symbolic Device Allocation 
table (CHBSDA) can then be generated. 
Then, picking up the global symbols and 
inserting their values into the CSECT, the 
following tables are generated: 

System Operator ID table (CHBSOT) 

Available Device table (CHBHED) 

Configuration Control Block (CHBCCB) 
containing the following tables: 

CPU Status table (CCBCST) 
Drum Path table (CCBDPT) 
Transmission Control Path table 
(CCBTPT) 

Channel Control Unit table (CCBCCT) 
Correspondence. List (CCBCLT) 
Printer Path table (CCBPRT) 



Paging Statistical Data table (CHBPSD) 

Statistical Data table (CHBSDT) 

Core Block Table Header (CHBCBH) 

Core Block table (CHBCBT) 

Support System Device Allocation header 

CCHBECXRA) 
Support System Device Allocation table 

(CHBECXRB) 
Virtual Memory Support System Allocation 

table CCHBECXVA) 
Public Volume table CCHBPVT) 
Terminal Device Table (CHBTDE) 
Remote Job Entry Table (CHBRJE) 
Bulk Communication Table (CHBBCT) 



The second half of this SYSGEN phase 
occurs when the system programmer executes 
the TSS*****. APGEN command procedure to use 
this SYSGEN. MODULE data set to update the 
system tables and control blocks on the IPL 
Volume. Following is a list of the com- 
mands and linkage editor statements within. 
TSS*****. APGEN. (Refer to: IBM System/360 
Time Sharing System: System Generation and 
Maintenance , GC28-2010, "Appendix G: Pro- 
cedure for Making TSS/360 Operational. 8. 
Contents of the APGEN procedure," for the 
procedure to both modify and execute this 
command procedure. ) 

Contents of the APGEN Command procedure: 

LOGON TSS 
SECURE (DA=1,2314) 
DDEF CEIDALIB, VP,DSNAME=SYSGEN. MODULE, 

DISP=OLD 
DDEF GENCCB,VP,DSNAME=SYSCCB(0) ,DISP=0LD 
RUN LNK 

CCBLNK,N, ,GENCCB,VID,N,Y 
RENAME CHBECXVA, CHBECXRA, CHBECXRB 
RENAME SYSGEX 

RENAME CHBSYS, CHBSAC , CHBDEV, CHBCHL, CHBMCH 
RENAME CHBSCH , CHBCUT , CHBSCN , CHBSMC , CHBCBH 
RENAME CHBCBT, CHBPSD , CHBSCM, CHBSDA, CHBPVT 
RENAME CHBSOT , CHBHED , CHBAHD , CHBAVE , CHBSDT 
RENAME CHBTDE, CHBRJE , CHBSST , CHBBCT 
INCLUDE CEIDALIB (SYSGEN) 
END 

RELEASE GENCCB 
ERASE SOURCE. CCBLNK 

DDEF GENSUP , VP , DSNAME=RESSUP ( ) , DISP=OLD 
RUN LNK 

SUPLNK , N , , GENSUP , VID , N , Y 
RENAME CHBECXVA, CHBECXRB 
RENAME SYSGEX 

RENAME CHBCCB, CHBSCM, CHBSDA, CHBSOT, CHBHED 
RENAME CHBAHD, CHBAVE, CHBSDT, CHBPVT, CHBBCT 
INCLUDE CEIDALIB (SYSGEN) 
END 

RELEASE GENSUP 
ERASE SOURCE. SUPLNK 

DDEF GENIVM,VP,DSNAME=SYSIVM(0) ,DISP=OLD 
RUN LNK 

IVMLNK,N, ,GENIVM,VID,N,Y 
RENAME CHBECXRA, CHBECXRB 
RENAME SYSGEX 
RENAME CHBCCB, CHBSYS , CHBSAC , CHBDEV , CHBMCH 
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RENAME CHBSCH, CHBCUT, CHBCHL, CHBSMC, CHBSCN 
RENAME CHBCBH ,CHBCBT , CHBPSD, CHBTDE, CHBRJE, 
RENAME CHBSST f CHBBCT 
INCLUDE CEIDALIB(SYSGEN) 
END 

RELEASE GENIVM 
ERASE SOURCE. IVMLNK 

DDEF GENRSS , VP, DSNAME=RSSSUP ( > , DISP=OLD 
RUN LNK 

RSSLNK , N , , GENRSS , VID , N , Y 
RENAME SYSGEX 

RENAME CHBSYS , CHBSAC , CHBDEV, CHBCHL, CHBMCH 
RENAME CHBSCH , CHBCUT , CHBSCN , CHBSMC , CHBCBH 
RENAME CHBSOT , CHBHED , CHBAHD, CHBAVE , CHBSDT 
RENAME CHBCBT, CHBPSD, CHBSCM, CHBSDA, CHBPVT 
RENAME CHBCCB, CHBTDE, CHBRJE, CHBSST, CHBBCT 
RENAME CHBECXVA,CHBECXRA 
INCLUDE CEIDALIB ( SYSGEN) 
END 

ERASE SOURCE- RSSLNK 
RELEASE GENRSS 
RELEASE CEIDALIB 
LOGOFF 
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SECTION 5: FLOWCHARTS 



The flowcharts in this manual have been produced by an IBM program, using ANSI sym- 
bols. The symbols are defined in the left column below, and examples of their use are 
shown at the right. 



(terminal block 1 



CESS BLOCK 




SUBROUTINE 



PREDEFINED 




PREPARATION 



DEFINITION 



INDICATES AN ENTRY OR 
TERMINAL POINT IN A FLOW- 
CHART; SHOWS START. STOP, 
HALT, DELAY, OR INTERRUP- 
TION. MAY ALSO INDICATE 
RETURN TO THE CALLING 
PROGRAM. 



INDICATES A PROCESSING 
F( N TI« 'N «;R A DEFINED > I 
ERATION CAUS: NG CHANGE I 
VALUE, FORM OR LOCATION 
OF INFORMATION. 



INDICATES A DECISION OR 
SWITCHING-TY >E OPERATION 

THAT DETERMINES WHICH OF 
A NUMBER ( >F ALTERNATE 

PATHS SHOULD BE FOLLOWED. 



I NIC AlhS A OiBPOUI 1NE • 
M< DDL F THAI S Lb'HBH' 
IN THIS MANLM 



INDICATES A SUBROUTINE O 
MODULE "! HAT IS INCLUDED 
IN THE FLOWCHARTS OF AN- 
OTHER MANUAL. 



r~ >* 

l CCMNAME J 



MODNAME IS THE LOAD MODULE OR LIBRARY 

NAME OF THE ROUTINE DESCRIBED BY THIS 
FLOWCHART . 

OMMON NAME OF THE 



OTHERMOD INDICATES THE MODULES PASSING 
CONTROL TO THIS MODULE AND THEIR FLOW- 
CHARTS. 




VIA: PASSMECH 



UN T 1 1 <Nfc 


SUCH AS GET 


PUT, READ 


fcRITE, SIC), 


AND DEVIC 


-' NIP'S, MAO 


IN'TfFUOT ", 


)NF . 



INDICATES A PROCESS THAT 
CHANGES SYSTEM OPERATION, 
r b EXAMPLE, SETS A SWITCH, 
MODIFIES AN INDEX REGISTER, 
OR INITIALISES A ROUTINE. 




) 



EP= ENTRY FT 

CHART AC 

VIA: PASSMECH 



1M U AIES ENIF t I" < >h IX 

FROM A BLOCK ON ANOTHER 
PAGE OF THE SAME SET OF 
FLOWCHARTS . 



PROGRAM EXECUTION CONTINUES WITH BLOCK 
H3 WHEN THE DECISION IS NO, OR 
BLOCK E3 WHEN THE DEC I SON IS YES. 



£3: LABEL2 IS THE LABEL OF THE SECTION OF 

CODE IN THIS ROUTINE FROM WHICH CONTROL 
IS PASSED TO THE SUBROUTINE. CONTROL 
RETURNS TO THE NEXT INSTRUCTION FOLLOW- 
ING THE SUBROUTINE CALL. 



ENTRY FT IS THE ENTRY POINT. 



LABEL I IS THE LABEL OF THE SECTION OF 

ODE r? iM WHD H oNTPOL IS PASSED TO THE 
PREDEFINED PROCESS PDPNM, WHICH IS 
DOCUMENTED IN ANOTHER PUBLICATION 
! -PDPNM- MAY ALSO BE USED IN A PROCESS- 
ING BLOCK) . 



EXECUTION CONTINUES WITH BLOCK H3 WHEN 
THE DECISION IS YES, OR WITH BLOCK AT ON 
PAGE 2 OF THIS SET OF FLOWCHARTS WHEN 
THE DECISION IS NO. 

THE OFFPAGE CONNECTOR MARKED 01 H3 INDI- 
CATES THAT EXECUTION CONTINUES WITH BLOCK 
H3 FROM ANOTHER PAGE OF THIS SET OF FLOW- 
CHARTS. THIS CONNECTOR IS ALSO PAIRED 
WITH THE ONPAGE CONNECTOR FROM BLOCK D3. 
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Chart AA. SYSBLD (CEIFA) Overview (Page 1 of 16) 



S Y S BI ,D FLOWCHARTS : 

IN THE MAINLIKE FLOWCHART (PAGES 1 TO 16) ALL THE 
SERVICE ROUTINES ARE LINKED TQ DYNAMICALLY. WHEN A SERVICE 
ROUTINE RETURNS TO THE MAINLINE PROGRAM A TEST IS MADE 
ON AN ERROR CODE WHICH THE SERVICE ROUTINE GENERATES 



IN GENERAL REGISTER 15. IF THE ERROR O 
X'OO' FLOW CONTINUES IN THE MAINLINE PRi 
THE PROGRAM BRANCHES TO THE TERMINATE Ri 
SINCE THE SERVICE ROUTINES ARE USED QUITE 
THESE TWO LOGIC BLOCKS HAVE BEEN OMITTED ! 



DE IS EQUAL TO 

GRAM. IF NOT, 

UTINE (CEIFK) . 

XTENSIVELY, 

LLOWING EACH 



SERVICE ROUTINE LOGIC BLOCK. SEE EXAMPLE FLOWCHART BELOW. 
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Chart AA. SYSBLD (CEIFA) (Page 2 of 16) 



SYSBLD PRELUDE 



£ 1 | SYSBLD \ 





' 




^ ' 




CEIFA 


3A1 


INITIALIZE 



• 


' 


CEIFB 3B3 


INTERROGATE 
OPERATOR 



CEIFQ 04B2 




CEIFZA 08F2 


ADJUST DSCBS 






CREATE USER 
LIBRARY 






1 1 






f 


CEIFD 5B1 






CEIFF 08B4 


UPDATE 
PATHFINDING 

TABLES 


CREATE CATALOG 
ROUTINE 


_ " 






Tt " 


CEIFG 06B1 






CEIFTD 09B1 


UPDATE VIRTUAL 

STORAGE 

i 


UPDATE CATALOG 
JFCB 


E . 1 


' 






„,, " 


CEIFI 07B1 






CEIFJ 10B1 


UPDATE 
CONFIGURATION 
CONTROL BLOCK 


SET UP VOLUMES 
FOR STARTUP 


„-, 


' 






1 


f 


CEIFE 08B1 






CEIFK 10B3 






TA 


3LE 






SYS 


3LD 



^ 

f WAIT 1 



Section 5: Flowcharts 59 



Chart AA. SYSBLD (CEIFA) (Page 3 of 16) 
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Chart AA. SYSBLD (CEIFA) (Pacje 4 of 16) 
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Chart AA. SYSBLD (CEIFA) (Page 5 of 16) 
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Chart AA. SYSBLD (CEIFA) (Page 6 of 16) 
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Chart AA. SYSBLD (CEIFA) (Page 8 of 16) 
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Chart AA. SYSBLD (CEIFA) (Page 9 of 16) 
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Chart AA. SYSBLD (CEIFA) (Page 10 of 16) 
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Chart AA. SYSBLD (CEIFA) (Page 12 of 16) 
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Chart AA. SYSBLD (CEIFA) (Page 13 of 16) 
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Chart AA. SYSBLD (CEIFA) (Page 14 of 16) 
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Chart AA. SYSBLD (CEIFA) (Page 15 of 16) 
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Chart AA- SYSBLD (CEIFA) (Page 16 of 16) 
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Chart AB. SYSBLD/STARTUP Prelude (CEIAP) 
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Chart AC. Startup (CEIAA) (Page 1 of 15) 
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Chart AC. Startup (CEIAA) (Page 2 of 15) 
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Chart AC. Startup (CEIAA) U?age 3 of 15) 
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Chart AC. Startup (CEIAA) (Page 4 of 15) 
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Chart AC. Startup (CE1AA) (Page 5 of 15) 
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Chart AC. Startup (CEIAA) (Page 6 of 15): SDAT Mainline - SDATRT 
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Chart AC. Startup (CEIAA) (Page 7 of 15): SDAT Entry Processor - SDA500 
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Chart AC. Quickstart (CEIAB) (Page 10 of 15): Quickstart Mainline Continued 
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Chart AC. Quickstart (CEIAB)(Page 11 of 15): PAGRT 



SUBROUTINE WRITES IVM 



PAGES FOR 



V^IS PAGiWIlNw 
if DEVICE A DRU."0 


YES 




CONVERT 


XPT OR 






RPN FORMAT 




X*NO 








RT1 2 


f 








EIAA2 




READ PAGE INTO 
BUFFER 









RECPG 


RECORD IN AND 
UPDATE 

RECORDING BUFF 


' 


' 


DSC30/DSC6O 


FIND AND WRITE 

OUT CURRENT CM 

PAGE 



i 





THIS 
NUMBER OF PAGES PER SEG 
POINTER TO XPT OR XSPT 
ENTRY LENGTH 
<S IF XPT, 12 IF XSPT) 
DEVICE TYPE CODE - SDA 
PAGING DEVICE FOR THIS 
SEGKENT tPPV OR SPVI 




l RETURN J 



Section 5 : 



Flowcharts 85 



Chart AC. Quickstart (CEIAB) (Page 12 of 15): DSCBE Locate, Create Format-E DSCB 
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Chart AC. Quickstart (CEIAB) (Page 13 of 15): DSCF/DSCFA Page 1 
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Chart AC. Quickstart (CEIAB) (Page 14 of 15): DSCF/DSCFA Page 2 
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Chart AC. Quickstart (CEIAB) (Page 15 of 15): DSCF/DSCFA Page 3 
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Chart AE. GENSCB Macro (CEIDA) (Page 1 of 2) 
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GENERATE SYSTEM 

TABLE FROM DATA 

IN DISPAR, 

VMPAR, AND 

TSKLMT 



GENERATE SYSTEM 

STATISTICS 

TABLE 



GENERATE SYSTEM 

COMMAND FROM 
DATA IN DISPAR, 

CLOP 



GENERATE SCAN 

MASTER CONTROL 

TABLE 




-E3- 



SET CONTROL 

UNITS ASSIGNED 

TO MULTIPLEXER 

CHANEL TABLE 

USING DCU 



-F3- 



SET CONTROL 

UNITS ASSIGNED 

TO SELECTOR 

CHANNEL TABLE 

USING DCU 



L 



LOOP ON CHANNEL 
CNTRL UNIT ADDR 
GEN CNTRL UNIT 
TBL FOR EXIST. 
ENTRIES 



INCREMENT 
CONTROL UNIT 

INDEX 




PUT ALTERNATE 

PATH INTO 

DEVICE GROUP 

TABLE 

FORPRIMARY PATH 



LOOP IN CHANNEI 

CONTROL UNIT 
ADDR . GENERATE 

FLAGS FOR 
ENTRIES 



GENERATE 
CHANNEL TABLE 
FROM DATA IN 
CHANNEL MACRO 



SET INDEXES FOR 

CHANNEL, 

CONTROL UNIT 

MATRIXES=1 




LOOP ON DEVICE 

ADDR, GENERATE 

DGT AND SAC 

TABLE ENTRIES 



INCREMENT 

CHANNEL INDEX, 

SET CONTROL 

UNIT INDEX=1 



I 
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Chart AE. GENSCB Macro CCEIDA) (Page 2 of 2) 




PUT LAST ENTRY 
IN SYMB. TO 

ACT. CONVERSION 
TABLE 



LOOP THROUGH 

SYMBOLIC DEVICE 

MATRIX. 

GENERATE SDAT 



GENERATE SYSTEM 

OPERATOR ID 

TABLE 



-El- 



GENERATE 

AVAILABLE 

DEVICE TABLE 

USING DEVICE 
COUNTS 



GENERATE 

CONFIGURATION 

CONTROL BLOCK 

HEADER 



GENERATE DRUM 

PATH TABLE OF 

CCB 



GENERATE 
TRANSMISSION 
CONTROL PATH 
TABLE OF CCB 



GENERAL CHANNEL 
CONTROL UNIT 
TABLE OF CCB 



GENERATE 

CORRESPONDENCE 

LIST OF CCB 



GENERATE 
PRINTER PATH 
TABLE OF CCB 



LOOP ON SYMB. 
DEVICE MATRIX. 
GENERATE DIRECT 

ACCESS PAGE 
STAT. DATA TBL 



-D3- 



LOOP ON SYMB. 
DEVICE MATRIX. 

GENERATE I/O 

STATISTICAL DEV 

TBL 



GENERATE CORE 

BLOCK TABLE 

HEADER 



-B4- 



GENERATE 

SUPPORT SYSTEM 

DEVICE 

ALLOCATION 

HEADER 



CHBECXRB 



GENERATE 

SUPPORT SYSTEM 

DEVICE 

ALLOCATION 

TABLE 



CHBECXVA 



-D4- 



GENERATE 

VIRTUAL MEMORY 

SUPPORT SYSTEM 

ALLOCATION 

TABLE 



GENERATE 
TERMINAL DEVICE 

TABLE 



r~ ^ 

f MEND V 
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APPENDIX A: SYSTEM TABLE FIELDS SET BY SYSGEN MACROS 



This appendix is constructed as follows: 
the fields are listed in the order in which 
they are set by the GENSCB mctcro; the name 
of each field is followed by a description 



of the entry, then the name of the macro in 
which the global symbol is set, the operand 
of that macro, and the default option are 
listed. 



SYSTEM TABLE (CHBSYS) 



FIELD 

SYS LOW 

SYSHI 

SYSFLI 

SYSECB 

SYSXPG 

SYSMGPTP 

SYSTLM 

SYSTID 

SYSRSC 

SYSMND 

SYSMXD 

SYSDATA 

SYSMXS 

SYSMNS 

SYSSCH 

SYSMWX 

SYSMWT 

SYSBUF 

SYSXTS 

SYSPSL 

SYSAST 

SYSAPT 

SYSRS1 

SYSRS2 

SYSRS3 

SYSRS4 

SYSRS5 

SYSRS6 

SYSDLY 

SYSDTRL 

SYSTSEM 

SYSTCR 

SYSIDL 

SYSCCAIV 

SYSPT1 

SYSPT2 

SYSPT3 

SYSBLK 

SYSBLK2 



DESCRIPTION 

Low Core Threshold (LOW) 

Low Core Threshold (HIGH) 

Flags 

Estimated Core Blocks Available 

Number of XTSI pages to trigger XTSI paging 

Number of page table pages for migration 

System TSI Limit 

Last Task ID Number Assigned 

Count of Pages in Supervisor Core's Reserve 

List 

Lower Shared Page Drum Threshold 

Upper Shared Page Drum Threshold 

Number of entries to expand page table 

Maximum Number of Shared Pages 

Minimum Number of Shared Pages 

SVC Charge Value 

Maximum Shared Pages To Purge 

Scan Shared Pages Threshold 

Buffer Size On Drum 

XTSI size limit 

Maximum number of public segments allowed 

Auxiliary Stop Threshold 

Auxiliary Primary Threshold 

PSW To Enter RSS Via Program Interruption 

PSW To Enter RSS Via SVC Interruption 

PSW To Enter RSS Via Interruption Key 

PSW To Enter RSS Via I/O Interruption 

PSW To Enter RSS Via Channel Interruption 

Processor 
PSW To Enter RSS Via GQE on TSI 

TSEND Delay Time 

Delta Length (Timer Count Per Master Tick) 

TSE Maximum Count 

Task Core Requirement 

Idle Timer Setting 

Contiguous Storage Interruption Timer 

Pointer to fixed area of CHASST 

Pointer to drum area of CHASST 

Pointer to disc area of CHASST 

Maximum pages blocked to drum 

Combined maximum pages blocked to drum and 

disk 



MACRO 


OPERAND 


DEFAULT 


DISPAR 


LCT(l) 


1 


DISPAR 


LCT(2) 


10 


VMPAR 


OPTIONS 


00 
90 


TSKLMT 


XTSIPGS 



8 
50 


TSKLMT 


TASKS 






16 






2 






250 






300 


TSKLMT 


VLPTE 


3 

30 
15 
77 


DISPAR 


PURGSH 


22 


DISPAR 


THRESH 


10 


DISPAR 


BUFSIZ 


64 


TSKLMT 


PGTBL 


16 


TSKLMT 


PSLMT 


6 


DISPAR 


AUXSP(l) 


SYSBUF+l0 1o 


DISPAR 


AUXSP(2) 


100 

00040F00 

V ( CEHAP A) 

00040F00 

V(CEHASA) 

00040F00 

V(CEHAEA) 

00G40F00 

V(CEHADA) 

00040FOO 

V(CEHACA) 

00040F00 

V(CEHAQA) 

524288 

255 

255 

55 

9615 

3 

V(SSTLHT) 

V(SSTLH2) 

V(SSTLH3) 


DISPAR 


BLKSZE 


12 


DISPAR 


BLKSZE 


20 
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SYSTEM COMMON (CHBSCM) 



SCMLPR Installation Legitimate Privilege Classes 

SCMPDC Number of Public Devices 

SCMCFM Installation Default for Card Forms 

SCMPFM Installation Default for Printer Forms 

SCMNCP Nonconversational order priority 

SCMOCF Operator Confirmation Default 

SCMBPR Batch priority code default 

SCMOMS Operator Message Option Default 

SCMTAP Installation Tape Default 

SCMTA1 Number of 7-track Tapes 

SCMTA2 Number of 7-track Data Conversion Tapes 

SCMTA3 Number of 9 -track Tapes 

SCMDA Installation Direct Access Default 

SCMDA1 Number of 2311 Direct Access Devices 

SCMDA3 Number of 2314 Direct Access Devices 

SCMPTN Number of Paper Tapes 

SCMPUN Number of Punches 

SCMRDN Number of Readers 

SCMPRN Number of Printers 

SCMDET Total Number of Devices 

SCMTDN Installation Tape Density Default 

SCMORG Installation DS Organization Default 

SCMLAB Installation Label Type Default 

SCMPRV Installation Default Privilege Class 

SCMPSP Installation Default Primary Page Space 

Allocation 

SCMSSP Installation Default Secondary Page Space 

Allocation 

SCMPSC Installation Default Primary Cylinder Space 

Allocation 

SCMSSC Installation Default Secondary Cylinder 

Space Allocation 

SCMSST Installation Default Secondary Track Space 

Allocation 

SCMUL1 User Library Primary Page Space Allocation 

SCMUL2 User Library Secondary Page Space 

Allocation 

SCMMAV Default Maximum Auxiliary Storage 

SCMAUX Auxilliary space overcommitment 

SCMIDP Installation default external priority 

SCMQST Minimum pages on ACV permitting allocation 

SCMIPL Installation Default Prompt Limit 

SCMATH Installation Default Authorization 

SCMFIR Installation Default FORTRAN Interruption 

Recovery 

SCMTIM Task time interval 

SCMMVD Multi- volume flag 

SCMATV ACV threshold valve 



CLOP 


PRVLG 


78000000. 
1 


CLOP 


CFM 


5081 


CLOP 


PFM 


419K 


CLOP 


OPCONF 


Y 


CLOP 


OPMSG 


M 


CLOP 


TATYPE 


00 


DEVGRP 







DEVGRP 







DEVGRP 




2 


CLOP 


DATYPE 


01 


DEVGRP 




3 


DEVGRP 







DEVGRP 







DEVGRP 




1 


DEVGRP 




1 


DEVGRP 




1 


DEVGRP 




A 


CLOP 


DEN 


43 


CLOP 


DSORG 


05 


CLOP 


LABTYP 


02 


CLOP 


PRVLG (1) 


D 


CLOP 


DAPAGES(l) 


16 


CLOP 


DAP AGES { 2> 


08 


CLOP 


DACYLS(l) 


2 


CLOP 


DACYLS ( 2) 


1 


CLOP 


DATRKS 


8 


CLOP 


LIBPGS(l) 


16 


CLOP 


LIBPGSC2) 


08 


CLOP 


MAV 


256 


CLOP 




8 


GENSCB 






CLOP 


PRMTLMT 


5 


CLOP 


AUTH 


U 


CLOP 


FIR 


Y 


VMPAR 


TIME 


01000000 


GENSCB 




80 


GENSCB 




12C 



CHANNEL TABLE (CHBCHL) 



CHLCUT Control Unit Table Pointer 

CHLPTR Multiplexer/Selector Channel Table Pointers 

CHLCS Control Units Assigned Table Size 

CHLFLG Flags for Each Channel 

CHLDIGn Device Interaction Groups (Note) 



CHANNEL SEL f MPX 

DCU ADDRESS 

CHANNEL SEL,MPX 

DEVGRP NONE 



CHBCUT 



00 

02 

N/A 



Note : No entries are made for non-existent 
channels for the fields CHLDIG1 and 
CHLDIG2. The setting of the fields is 
determined by analysis by SYSGEN, the ana- 
lysis being done on the scan table 
(CHBSCN) . 
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MULTIPLEXER CHANNEL TABLE (CHBMCH) 



MCHF Not used 

MCHFLG Flag Field 

MCHCTD Control Unit Table Displacement 



DCU 



ADDRESS 





4000 





S ELECTOR CHANNEL TABLE (CHBSCH) 

SCHFLG Flag Field DCU 

SCHCTD Control Unit Table Displacement 

Note : MCHFLG and SCHFLG are set to X'0000 f 
if the control unit exists, and to X'4000' 
if the control unit does not exist. MCHCTD 
and SCHCTD are calculated for existing con- 
trol units by SYSGEN. 



ADDRESS 



4000 




CONTROL UNIT TABLE (CHBCUT) 

CUTMAX Number of Control Unit Entries in Table DCU 

CUTFP Control Unit Table Flag Area 

CUTDGP Device Group Table Pointer for Control Unit DCU 

N 

CUTFLG Flags for Control Unit N DCU 

CUTS Switch Flag in CUTFLG 

CUTC Entry Type Flag in CUTFLG 

CUTDIGn Device Interaction Group DEVGRP 

Note ; No entries are made for nonexistent 
control units, for the fields CUTDGP and 
CUTFLG, The settings of the flags CUTS and 
CUTC are determined by analysis by SYSGEN, 
the analysis being done on the ADDRESS 
operand of the DCU Macro. 

No entries are made for nonexistent control 
units for the fields CUTDIG1 through CUT- 
DIGS, The setting of the fields is deter- 
mined by analysis by SYSGEN, the analysis 
being done on the scan table (CHBSCN) . 



ADDRESS 
ADDRESS 
ADDRESS 

NONE 



CHBCUT1 



00 
00 
N/A 



DEVICE GROUP TABLE (CHBDEV) 

DEVLOCK Lock Byte 

DEVMAX Maximum Device Address in Table 

DEVF Table Flags 

DEVAEP Asynchronous Interruption List Pointer 

DEVPP Actual Paths to Device 

DEVFLG Device Flags 

DEVTP Device Type 

DEVSDA System Symbolic Device Address 

DEVASD System Symbolic Device Address 

DEVI Asynchronous Interruption Flags 



DEVGRP 


ADDRESS 





DEVGRP 


PATH 





DEVGRP 


PATH 





DEVGRP 


PATH 


SYSGEN 

VCON 




DEVGRP 


UNIT 


01 


DEVGRP 


ADDRESS 





DEVGRP 


ADDRESS 







SACDA 
SACDP 



SYMBOLIC TO ACTUAL ADDRESS CONVERSION TABLE (CHBSAC) 

Actual Device Address DEVGRP ADDRESS 

Device Group Table Pointer 

Note : The Device Group Table Pointer is 
the displacement from CHBDEV to the corres- 
ponding Device Group Table. 





SEE NOTE 
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SYMBOLIC DEVICE ALLOCATION TABLE (CHBSDA) 



SDAHPS First Public Device 

SDAHAL Address of Last Entry 

SDALOC System Lock Byte 

SDAFLA First Flag Byte 

SDASDA Symbolic Device Address 

SDADEV Device Code 

SDATID Task ID 

SDAMRB Maximum Number of IORCBs 

SDAUSC User Count 

SDAFLB Second Flag Byte 

SDADM4 Third Flag Byte 

SDASPC Total Space Capacity of Volume 

SDATAP Tape Position Code 

SDAVID Volume ID 

SDANLC Number of Logical Cylinders/Volume 

SDALCS Number of Tracks/Logical Cylinder 

SDATRL Number of Available Bytes/Track 

SDAOHI Overhead for Keyed Record 

SDAOHL Overhead for Last Keyed Record on Track 

SDAOHK Overhead Bytes to be Subtracted if no Key 

SDATOL Tolerance/512 Gives Effective 



DEVGRP TYPE, 
IOREQ 
DEVGRP ADDRESS 
DEVGRP UNIT, 

FEATURE 



DEVGRP 
DEVGRP 



MAXIO 
TYPE 





SDALST 



82 


00000000 



2 



80 

























SYSTEM OPERATOR ID TABLE HEADER (CHBSOT) 



SOTLNG Number of Table Entries - Binary 

SOTBCK Symbolic Device Address of Backup Terminal 

SOTUID User ID - EBCDIC 

SOTDES Destination Flag 

SOTLOG Logon Flag 

SOTTID Task ID - Binary 

SOTSIN Console Symbolic Device Address 



OPCHSL 



ADDRESS 



SYSTEM OPERATOR ID TABLE (CHBSID) 



SIDUID User ID - EBCDIC 

SIDDES Destination Flag 

SIDLOG Logon Flag 

SIDTID Task ID - Binary 

SIDSIN Console Symbolic Device Address 



OPCNSL 



ADDRESS 



SYSOP000, 

1, 2, 3 

00, 01, 

02, 0** 

01, 00, 
00, 00 






AVAILABLE DEVICE TABLE (CHBHED) 



HEDLCK Lock Byte 

HEDCNT Count of Subqueue Headers 

HEDSPR Spare Bytes 



DEVGRP 



UNIT, 
ADDRESS 



AHDDTC 

AHDADR 

AHDLCK 
AHDCNT 



SUBQUEUE HEADERS CCHBAHD) 
Device Type Code (Same as SDSDEV in SDAT) DEVGRP 
Pointer to First Subqueue Entry 



Header Lock Byte 

Number of Entries in the Subqueue 



DEVGRP 



UNIT 



UNIT, 
ADDRESS 



SAME AS 

SDAT 

SET BY 

SYSGEN 

00 

NO HEADER 
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SUBQUEUE ENTRIES CCHBAVE) 



AVEDEV Full Device Code (Same as SDASEV in SDAT) 
AVEPNT Pointer to SDAT Entry 



DEVGRP 



UNIT 



NO ENTRY 
SET BY 

SYSGEN 



CONFIGURATION CONTROL BLOCK HEADER (CHBCCB) 



CCBNDM Number of Drums of Installation 

CCBDPP Relative Pointer to Drum Path Table 
CCBTPP Relative Pointer to Transmission Control 

Path Table 
CCBNCC Number of Channel Controllers at 

Installation 
CCBCPT Relative Pointer to Channel Controller 

Table 
CCBPCL Relative Pointer to Correspondence List 
CCBNPR Number of Printers at Installation 

CCBPPT Relative Pointer to Printer Path Table 

CCBLSD Length of Shared iData Set Table 

CCBLDA Low Drum Availability Constant 

CCBCON Maximum number of conversational tasks 

CCBMTT Maximum number of MTT administrator's tasks 

CCBVMB Storage Assigned to Variable-length Control 

Sections 

CCBTER Number of user and operator's terminals 

CCBBUF Buffer size for input data 

CCBBAT Maximum number of patch tasks 

CCBBAK Maximum number of background tasks 



Note: 



Relative Pointers above are calcu- 



DEVGRP 



UNIT, 
ADDRESS 



CHANNEL MPX,SEL 



lated by SYSGEN , and each is equal to the 
number of bytes from CHBCCB to the begin- 
ning of the specific table. 



CCB CPU STATUS TABLE (CCBCST) 



SEE NOTE 
SEE NOTE 







SEE 


NOTE 






SEE 


NOTE 


DEVGRP 


UNIT, 
ADDRESS 










SEE 


NOTE 


VMPAR 


SDST 


10 




DISPAR 


LDMTR 


2% 




TSKLMT 


CONV 






TSKLMT 


MTTADM 






VMPAR 


VCSLNG 


20 




GENSCB 








VMPAR 


TBUFS 


200 




TSKLMT 


BATCH 






TSKLMT 


BACK 







CSTIDO Identity Byte 

CSTMDL Model Number of CPUs at Installation 

CSTNOP Number of CPUs at Installation 

CSTNAP Number of Storage Elements in TSS Domain 

CSTSET Relative Pointer to SE Status Table 



CSTID1 ID Field for Ext€»rnal Interruption 

CSTID2 ID Field for External Start 

CSTID3 Interruption Code on Malfunction Alert 

CSTCST CPU Status (00=Available) 

CSTPF1 Primary Prefix 

CSTPF2 Alternate Prefix 

CSTSST SE Status (00=Available) 

CSTFSA Floating Storage Address 

Note ; The following values are filled in 
by SYSGEN for existing CPUs: 










CPU 


MODEL 


2 


CPU 


NUM 


1 


STEM 


NUM 


2 

# Bytes 

from 

CCBCST 

SEE NOTE 

BELOW 


CPU 


NUM 


80 


CPU 


PRFX 





CPU 


ALTPRFX 





STEM 


NUM 


80 




CPU# 

1 

2 
3 
4 



ID1 

80 

40 

20 

10 



ID2 

08 

04 

02 

01 



ID3 

20 

10 

08 

04 
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CCBNPD 
CCBPTD 



Number of Paths to This Drum 
Path to Drum 



CCB DRUM PATH TABLE (CCBDPT) 

DEVGRP 



PATH 



NO ENTRY 



CCB TRANSMISSION CONTROL PATH TABLE (CCBTPT) 



CCBADD Path to Transmission 

Control Line 
CCBDTC Device Type Code 
CCBDCL Device Class 
CCBUNT Unit Type 
CCBOPF Optional Features 





DEVGRP 


UNIT 


NO ENTRY 


Same as SDAT 


DEVGRP 


UNIT 


NO ENTRY 


SDADEV Field 


DEVGRP 


UNIT 


NO ENTRY 




DEVGRP 


UNIT 


NO ENTRY 




DEVGRP 


FEATURE 


NO ENTRY 



CCB CHANNEL CONTROL UNIT TABLE (CCBCCT) 



CCBNCH Number of Channel Connected to Channel 

Cont. 
CCBCAD Channel Address 



CHANNEL MPX f SEL 
CHANNEL MPX,SEL 



NO ENTRY 



CCBPCM 



CCB CORRESPONDENCE LIST (CCBCLT) 



Path to Control Unit 



DEVGRP PATH 



NO ENTRY 



CCB PRINTER PATH TABLE (CCBPRT) 



CCBNPP Number of Paths to This Printer 
CCBPTP Path to Printer 



DEVGRP 
DEVGRP 



PATH 
PATH 



NO ENTRY 



PSDLSD 
PSDLWA 



DIRECT ACCESS PAGING STATISTICAL DATA RECORD HEADER (CHBPSD) 

Length of SDR Entry (80 Bytes) 
Last Word Address 



80 
LASTWORD 



DAPSDR ENTRY 



PSDSDA Symbolic Device Address 

PSDFB Flag Byte 

PSDLSA Last Seek Address 

PSDLP Path Last Used 

PSDEIC Total Error - Incident Count 

PSDRET Total Retry Count 

PSDRTH Retry Thresholds 

PSDTS Error Time Stamp 

PSDSDR SDR Buckets (64 half- bytes) 



DEVGRP 



ADDRESS 



DEVGRP 



UNIT 



NO ENTRY 











SEE NOTE 







Note : Retry thresholds are as follows: 

For 2301 Drum - X" 0101010A0505000000000000 f 

For 2311 or 2314 Disk - X f 01020A020AOAOAOA0A00OO00 i 

For 2302 - X' 020202010AOAOAOAOA010000 t 

For other Devices - No entry in DAPSDR 



SCAN MASTER CONTROL TABLE (CHBSMC) 



SMCMLB Master Lock Byte 
SMCMCT Master Count of GQEs 
SMCDCT Count of Digs 






calculat- 
ed by 

SYSGEN 
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SMCCMF Master Count of Matched Facilities 

SMEDLB Dig Lock Byte 

SMEBFG Flag Byte 

SMECMF Count of Matched Facilities 

SMEFEA First Entry Address 

SMECEA Current Entry Address 

SMELEA Last Entry Address 











SYSGEN 

adcon 



SYSGEN 

adcon 



SCAN TABLE (CHBSCN) 



SCNFB1 Flag Byte Number 1 
SCNDID DIG code 



SCNLOK Lock Byte 

SCNPRO Processor Pointer 

SCNFQE First Queue Entry 

SCNLQE Last Queue Entry 



calculat- 
ed by 
SYSGEN 


SYSGEN 
VCON 





I/O STATISTICAL DATA TABLE (CHBSDT) 



SDTLSD Length of an SDR Entry (72 Bytes) 

SDTLBA Last Byte Address of SDT 

SDTSDA Symbolic Device Address 

SDTFB Flag Bytes 

SDTLP Path Last Used (Actual I/O Address) 

SDTEIC Total Error Incident Count 

SDTRET Total Retry Count 

SDTRTH Retry Thresholds 

SDTTS Time Stamp at Error Incident N 

SDTSDB SDR Buckets (64 half- bytes) 



DEVGRP 



ADDRESS 



DEVGRP UNIT 



72 

SYSGEN 

ADCON 

ENTRY 









SEE NOTE 





Note : Retry Thresholds are as follows: 



For 
For 
For 
For 
For 
For 
For 
For 
For 



2400 Tapes - X" OF0503052805000000000000" 

2311 or 2314 - X" 0A0AOA0AOAFF020A0AO00O00" 

2301 Drum - X" 0100010A0505000000000000" 

2540 Reader - X 1 050205050000000000000000' 

1050 - X , 030303030303030303030AOO" 

2780 - X'030312000303030303000000" 

any other Device - X f 000000000000000000000000" 



2540 Punch - X 
1403 Printer - 



0202020 20000000000000000" 
X" 050303030200000000000000 ■ 



CORE BLOCK TABLE HEADER (CHBCBH) 



CBHUNA Pointer to Unassigned Chain 

CBHPNX Pointer to Pending Non-XTSI-PSW Chain 

CBHPXP Pointer to Pending XTSI-PSW Chain 

CBHAVC Count of Available Blocks 

CBHLOCK Lock Byte for CBT 

CBHBSE Base Address for Start of Memory 

CBHSZE Number of Core Blocks in Memory 



STEM 



NUM 













CORE BLOCK TABLE (CHBCBT) 



CBTFLK Entry - Forward Link 

CBTTPT TSI Pointer 

CBTVMA Virtual Memory Address 



Appendix A: System Table Fields Set by Sysgen Macros 99 



CBTFLG 
CBTRLK 



Flags 
Reverse Link 








PVTMCT 



PUBLIC VOLUME TABLE (CHBPVT) 



Maximum Volume Entry Count 



PUBVOL MAXVOL 



10 



SUPPORT SYSTEM DEVICE ALLOCATION TABLE (CHBECX) 



ECXBFDE PTR to 1st Non-resident Device Entry 

ECXBLDE PTR to Last Non-resident Device Entry 

ECXBSDA Symbolic Device Address 

ECXBPHP Physical Path 

ECXBPHP2 Alternate Physical Path 



ECXBDEV Device Defining Information 

Note : If no alternate physical path 
exists, the half-word field is set to 
X'FFFF' . 



DEVGRP 
DEVGRP 

DEVGRP 



DEVGRP 



ADDRESS 

ADDRESS, 

PATH 

ADDRESS, 

PATH 



SYSGEN 
VCON 
SYSGEN 
VCON 



SEE NOTE 



TERMINAL DEVICE TABLE (CHBTDE) 



TDEFTD First Terminal Device Pointer 

TDELTD Last Terminal Device Pointer 

TDESDA Symbolic Device Address 

TDEDEV Device Code 



DEVGRP 
DEVGRP 



ADDRESS 

UNIT, 

FEATURE 



SYSGEN 

ADCON 

SYSGEN 

ADCON 



00000000 



REMOTE JOB ENTRY TABLE (CHBRJE) 



Note ; Retry Threshold for 2780: 
X' 030312000303 030303000000' 



SYSTEM STATISTICS TABLE (CHBSST) 
SSTLHT SST total length - bytes 
SSTLH2 SST area 2 - bytes 
SSTLH3 SST area 3 - bytes 



calculated 
by SYSGEN 
calculated 
by SYSGEN 
calculated 
by SYSGEN 



BULK COMMON TABLE (CHBBCT) 

BCTDEF Default base time 

BCTSOI Operator Intervention 

BCTRUS Real time measurement unit 

BCTEUS Master service unit of time 

BCTALM ABEND limit 

BCTBSN Packed decimal batch sequence number 

BCTFL3 Interruption-driven flag (initially on) 

BCTALL Length of S-entries 



3000 

50 

1000 

100 

50 

255C 



100 



APPENDIX B: MACRO GLOBAL SYMBOL DESCRIPTIONS 



This appendix is structured as follows: 

• The system generation macro instructions are arranged in alphabetical order; 

• The global symbols set by each macro instruction are listed; and 

• For each global symbol there appears: 

the macro operand that sets the symbol (lower case entries indicate positional 
operand), the name of the System Control Block that is affected by the symbol, and 
the value assigned to the global symbol, if the macro operand is defaulted. 

Whenever a hardware address is found in a global symbol, its decimal value plus one is 
used. 



GLOBAL SYMBOL 

ecu 

JCCUNO 

I 

CHANNEL 



DESCRIPTION 



CHL(I)=C1|2}* 



NOCHN 



ONECB 



SELSOB 



Number of Channel Control Units 



MACRO 
OPERAND 



Number of chcmnel control units 



Describe Multiplexer and Selector 



Channels 



If the MPX operand is present, each 
address has its corresponding sub- 
scripted variable of CHL set to 1; 
if the SEL operand is present, each 
address has its corresponding sub- 
scripted variable of CHL set to 2. 

The sum of trie number of addresses 
in the MPX and SEL operands. 

Indicates the CHANNEL macro has 
been processed. 



*I is the representation of a channel 
hardware address. 



numccu 



MPX 
SEL 



SYSTEM 
CONTROL 
BLOCK 
AFFECTED 



CHBCCB 






CHBCHL, 
CHBMCH, 
CHBSCH, 
CHBCCB, 
CHBDEV, 
CHBCCT 



MPX 
SEL 



SELSUB 



CHBMCH 



DEFAULT 

^ 



(C,D,E,F) 



CLOP 



Specify Command Language Options 



AO 

JSCMTAP= EO 

00 



JSCMDA= 



JSCMMWT 



m 



Tape drive type default 

Direct access device type default 

Maximum wait time for operator 
response 



TATYPE= 7DC 
9 



DATYPE=|231l\ 



12314) 



MOWT 



CHBSCM 



CHBSCM 



CHBSCM 



00 
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GLOBAL SYMBOL 
JSCMOCF=(Y) 



JSCMOMS= 

JSCMIPL 
JSCMPSP 

JSCMSSP 

JSCMPSC 

JSCMSSC 

JSCMSST 
JSCMTDN= 

JSCMORG= 



{2} 



fg} 



JSCMLAB=(01 
<02 
f 04 



JSCMATH= 



& 



JSCMPRV, 
JSCMLPO r 
JSCMLP1, 
JSCMLP2 , 
JSCMLP3 

JSCMCFM 



JSCMPFM 
JSCMUL1 
JSCMUL2 



DESCRIPTION 

Confirmation or no confirmation 
of commands wanted 

Format of system messages to the 
operator 

Installation^ prompting limit 

Integer^- Number of pages used for 
default for VAM primary storage 
allocation 

Integer^ -Number of pages used for 
default for VAM secondary storage 
allocation 

Integer^ - Number of cylinders 
used for default for SAM 
primary storage allocation 



Integer 2 -Number of cylinders used for 
default for SAM secondary storage 
allocation 

Number of tracks used for default for 
SAM secondary storage allocation 

Tape recording density default 



Data set organization default 



Tape label default 



Default authorization assigned to a 
user when joined to the system 

Default privilege class assigned to a 
user when joined to the system, and 
other privilege classes 



Installation default identification 
for card forms 

Installation default identification 
for printer forms 

Integer^- Primary space allocation for 
a userlib 

Integer 2 - Secondary space allocation 
for a userlib 



MACRO 
OPERAND 



SYSTEM 
CONTROL 
BLOCK 
AFFECTED 



OPCONF| 






OPMSG 



PRMTLMT 
DAPAGES 

DAP AGES 

DACYLS 

DACYLS 

DATRKS 
DEN=(0) 

u 



DSORG=(PS 1 

)vi 

)VS 

(vp 


• 


LABTYP=(N1 
JS] 

(si 


L 
L 
JL 



AUTH= 



«} 



PRVLG 



CFM 



PFM 



LIBPGS 



LIBPGS 



CHBSCM 

CHBSCM 

CHBSCM 
CHBSCM 

CHBSCM 

CHBSCM 

CHBSCM 

CHBSCM 
CHBSCM 

CHBSCM 

CHBSCM 

CHBSCM 
CHBSCM 



CHBSCM 



CHBSCM 



CHBSCM 



CHBSCM 



DEFAULT 



M 

5 
16 

08 



43 



D,120 f 0, 
0,0 



CARDS 



PAPER 



16 
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JSCMFIR={Y|N> 



JSCMMAV 

JSCMIDP 

I 

CPU * 

JCSTNOP(I)= 



GLOBAL SYMBOL 



1 

2 

3 

14 J 



JCSTMDL(I)=fl 



{» 



JF1(I)=FLTADD 

JF2(I)=PTSNS 

JF3(I)=XCNTRL 

JCSTPFKI) 
JCSTPF2CI) 



I- 

DCU 



HCU(I) 



DCULAB (LABEL) 



HLAB 



CORLST (LABEL) 



DESCRIPTION 



FORTRAN interruption recovery on 
boundary violations desired 



Default maximum auxiliary storage 
Default external priority 
Describe a Central Processing Unit 



FIR=iY)N> 



MAV 
PRIO 



Each subscripted variable is assigned 
the identity of the CPU (except for a 
CPU1, MODEL 1) . 



Each subscripted variable is assigned 
the model number of the CPU 

Each subscripted variable is set to 
FLTADD if floating storage addressing 
is specified for the CPU 

Each subscripted variable is set to 
PTSNS if partitioning sensing is spe- 
cified for the CPU. 

Each subscripted variable is set to 
XCNTRL if extended direct control is 
specified for the CPU. 

Primary prefix storage area value 

Secondary prefix storage area value 

♦In all CPU global symbols, I repre- 
sents the identity of the CPU. 

Describe a Device Control Unit 



Each subscripted variable is assigned 
the highest hardware address (exclud- 
ing channel portion) from among the 
device control units attached to the 
channel represented by I. 

Each subscripted variable is set to 
the character value of the channel and 
device control unit of the first entry 
of the ADDRESS operand. 

The highest value specified in the 
LABEL operand 

For each device control unit with a 
label less than 33, an entry in the 
list consists of a halfword con- 
taining a count of the paths to the 
control unit through one controller, 
followed by the actual paths (one per 
halfword) ; a nonexi sting entry con- 
sists of a halfword of f FFFF'. 



MACRO 
OPERAND 



T T" 

SYSTEM 
CONTROL 
BLOCK 
AFFECTED 



+ + H 

CHBSCM 



cpuno= 



MODEL= 



it) 



CHBSCM 

CHBSCM 
+ 

CHBCST 



CHBCST 



FEATURE 

FEATURE 

FEATURE 

PRFX 
ALTPRFX 



ADDRESS 



ADDRESS, 
LABEL 



LABEL 



LABEL 



256 

8 
+"■ 1 



CHBCST 
CHBCST 






CHBSCH 



CHBCLT 



DEFAULT 



null 

null 

null 

null 
null 



null 



null 
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I GLOBAL SYMBOL 
J. 

|*DCUN(M) 



DESCRIPTION 



MACRO 
OPERAND 



Effectively, this is an NxM matrix 
where N represents a channel and M a 
device control unit. For the first 
entry of the ADDRESS operand, the 
DCUN(M) entry is set as follows (N and 
M are the channel and control unit of 
the first entry) : 

1) If DCUNCM) is null, it is set to 
the concatenation of the unit code 
and the model of the device and a 
left parenthesis. 

2) If DCUN(M) is not null and its 
first four characters are 
asterisks, the first five char- 
acters are replaced by the unit 
code and model number. 

For subsequent ADDRESS entries , the 
DCUN(M) entry is set as follows (N and 
M are the channel and control unit of 
the second entry) : 

1) If the channel of the subsequent 
entry is the same as the channel 
of the first entry, and if DCUN(M) 
is null, DCUN(M) is set to the 
channel and device control unit of 
the first entry concatenated to a 
zero and right parenthesis. 
However, if DCUN(M) is not null 
and the first four characters are 
asterisks, the first five charac- 
ters are replaced by the unit code 
and model number. 

2) If the channel of the subsequent 
entry is not the same as the chan- 
nel of the first entry and, if 
DCUN(M) is null, DCUN(M) is set to 
the concatenated character value 
of the channel and control unit of 
the first entry, zero, and the 
number of entries in the ADDRESS 
operand. The DCU entry for the 
first ADDRESS entry has an 
asterisk set to replace the left 
parenthesis originally set. 
However, if DCUNCM) is not null 
and the first four characters are 
asterisks, the first five charac- 
ters are replaced by the unit code 
and model number. 



SYSTEM 
CONTROL 
BLOCK 
AFFECTED 



UNIT, 
ADDRESS , 
MODEL=/l 
21 
3 

[51 
17, 






CHBCUT, 
CHBSCH, 
CHBDEV, 
CHBDPT 



DEFAULT 



null 
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GLOBAL SYMBOL 



N270X 



T270XCN270X) 



DEVGRP 



PNO(NM> 



MD(NM) 



DEVNM(D) 



DEVSNM(D) 



SYM(S) 



SYMACS) 



If UNIT = 2701, or 2702, or 2703 and 
if the channel specified in a subse- 
quent entry is different from the 
channel specified in the first ADDRESS 
entry, N270X is incremented by one so 
as to point to the next available 
subscripted variable in T270X. 

Each subscripted variable is assigned 
the channel and control unit portion 
from a 2701, 2702 or 2703 ADDRESS 
entry that has a channel different 
from the channel of the first entry 
of the ADDRESS operand. 

♦This global symbol is also set by the 
DEVGRP macro instruction. 

Describe a Device Group 



DESCRIPTION 



Effectively, this is an NxM matrix 
where N is the channel and M is the 
device control unit. An element of 
the matrix provides the number of 
paths specified in the PATH operand 
for the particular channel and device 
control unit. 

Effectively,, this is an NxM matrix 
where N is the channel and M is the 
device control unit. Each element of 
the matrix is set to the maximum 
number of devices specified for a 
particular channel and control unit. 

Ef fectively, r this is a NxMxD matrix 
where NMD represents the hardware 
address of a device. Each element 
of the matrix is set to the unit and 
type of device whose hardware address 
is NMD. 

Effectively, this is a NxMxD matrix 
where NMD represents the hardware 
address of a device. Each element 
of the matrix is set to the symbolic 
address that corresponds to the 
hardware address NMD. 

Each subscripted variable is assigned 
the hardware device address and type 
and IOREQ bit corresponding to the 
symbolic device address represented by 

s. 

Each subscripted variable is assigned 
the MAXIO value for the device whose 
symbolic address is represented by S. 



MACRO 
OPERAND 



SYSTEM 
CONTROL 
BLOCK 
AFFECTED 



UNIT, 
ADDRESS 



UNIT, 
ADDRESS 






PATH 



ADDRESS , 
PATH 



ADDRESS, 
PATH, UNIT, 
TYPE 



ADDRESS, 
PATH 



ADDRESS , 
PATH, 
TYPE, 

IOREQ=(YES* 
\ NO) 

ADDRESS , 
MAXIO 



CHBTPT 



CHBTPT 



+ 



CHBDEV 



CHBDEV 



CHBDEV, 
CHB272, 
CHBPSD, 
CHBSDT 



CHBDEV, 
CHB272 



CHBSDA, 
CHBDPT, 
CHBPSD, 
CHBSCN, 
CHBSDT 

CHBSDA 



DEFAULT 



null 



4 



null 



null 



null 



-X 
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GLOBAL SYMBOL 
SYMF(S) 



HYSM 






CTU 



SU(CTU) 



APRNT 



CPRNT(APRNT) 



GAPRNT 



JSCMTA1 



JSCMTA2 



JSCMTA3 



PGDRUM 



DESCRIPTION 



Each subscripted variable represents 
the features on a device whose sym- 
bolic address is represented by S. 

The highest symbolic address specified 



Effectively, CTU is a table with an 
entry for each unit represented by U. 
An entry is incremented by one each 
time a device for this particular 
unit is processed. 

Effectively, this is a UxCTU matrix 
where U represents a unit and CTU 
represents the n th (n=l r ...) 
occurrence of a device with this unit 
number. Each element of the matrix is 
set to the symbolic address of the 
device. 

A pointer to the next available entry 
in the CPRNT table. 



Each time a device in the group of 
1403 printers is processed, a new 
block of symbolic variables in CPRNT 
is started. The first entry in a 
block is the number of paths specified 
in the PATH operand. If n is the 
number of paths, then the next n 
entries represent all the hardware 
addresses of a specific printer. 

A pointer to the next available block 

in CPRNT. 

Number of 7-track tape drives 



Number of 7-track tape drives with 
the data conversion feature 

Number of 9- track tape drives 



Number of paging drums 



MACRO 
OPERAND 



ADDRESS , 
FEATURE 



ADDRESS 



UNIT, 
ADDRESS 



ADDRESS, 
UNIT 



UNIT, 
PATH, 
ADDRESS 

UNIT, PATH, 
ADDRESS 






UNIT, PATH 



FEATURE, 
UNIT 

FEATURE, 
UNIT 

FEATURE, 
UNIT 

TYPE, UNIT 



SYSTEM 
CONTROL 
BLOCK 
AFFECTED 



CHBSDA, 
CHB272 



CHBSDT, 

CHBSDA, 
CHBPSD, 
CHBSCN 

CHBSCM, 
CHBHED, 
CHBAHD, 
CHBAVE, 
CHBCCB 

CHBAVE 



CHBPRN 



CHBCCB 



CHBSCM 



CHBSCM 



CHBSCM 



CHBSYS 



DEFAULT 



null 



null 
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GLOBAL SYMBOL 
ECXMMN(S) 






*DCUN(M) 



HISYMX(Y) 



LOSYMX(Y) 



DISPAR 



JSYSLOW 



DESCRIPTION 



Effectively, this is a NxS matrix, 
where N represents the path number and 
S represents the symbolic device 
address. The MM portion of the matrix 
is the index for the SDA value; i.e., 
ECXOIN(S) is the matrix for SDA 1-255, 
ECX02NCS) is the matrix for 
SDA 256-510, etc. The value of the 
matrix is set to the actual hardware 
address of tne device. 

Effectively, this is a NxM matrix 
where N represents a channel and M a 
device control unit. If there is 
more than one entry in the PATH 
operand and DCUN(M) is null (N and M 
represent the channel and control unit 
of the first PATH entry) DCUN(M) is 
set to ****0* where the last asterisk 
denotes more than one path to a device 
control unit and the first four 
asterisks are used for the device 
control unit type until it is defined 
in the DCU macro. If DCUN(M) is not 
null, an asterisk is placed after the 
five characters representing the unit 
and model. 

For subsequent PATH entries, the 
appropriate DCU entry is set to the 
character value of the channel and 
device control unit of the first PATH 
entry followed by a number indicating 
the position of the entry in the PATH 
operand. 

♦This global symbol is also set by the 
DCU macro instruction. 

Effectively, this is a XxY matrix 
where X represents the channel and Y a 
device control unit. The value is set 
equal to the high SDA on the control 
unit. 

Effectively, this is a XxY matrix 
where X represents the channel and Y a 
device control unit. The value is set 
equal to the low SDA on the control 
unit. 

Specify the Dispatching Algorithm 






Integers-Lower limit on available 
storage before starting a time-slice 
for a new task 



MACRO 
OPERAND 



ADDRESS, 
PATH 



SYSTEM 
CONTROL 
BLOCK 
AFFECTED 

CHBECXRA, 
CHBECXRB, 
CHBECXVA 



PATH 



ADDRESS 



ADDRESS 



+ 



LCT 



„ + 



CHBCUT, 
CHBSCH, 
CHBDEV, 
CHBDPT 



CHBSCN 



CHBSCN 



CHBSYS 






DEFAULT 

4 



null 



null 



null 
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h 



GLOBAL SYMBOL 



JSYSHI 

JCCBLDA 

JSYSMWX 
JSYSMWT 
JSYSBUF 
JSYSAST 

JSYSAPT 
JSYSBKD 
JSYSBDD 

JSYSTCR 



OPCNSL 



JOPCNSL(I) 



PUBVOL 



PUBNUM 
STEM 



PSUNO= 



PSUMDL= 



{j} 



DESCRIPTION 



Integer 2 -Upper limit on available 
storage before starting a time-slice 
for a new task 

Percentage of paging drum(s) to 
be allocated to auxiliary storage 
before overflow to paging disk(s) 

Maximum Shared Pages To Purge 

Scan Shared Pages Threshold 

Buffer Size On Drum 

Auxiliary Stop Threshold 

Auxiliary Primary Threshold 

Maximum pages blocked to drum 

Combined maximum pages blocked to 
disk and drum 

Task Core Requirement 



Describe Operator Consoles 



Each subscripted variable is assigned 
the concatenation of the hardware and 
symbolic device addresses specified 
for an operator console. 

+ + . 

Describe Public Volume Configuration 



Maximum number of public volumes in 
system. 

Describe Processor Storage Units 



Number of processor 
storage units 



Model number of the processor 
storage units 



MACRO 
OPERAND 



LCT 

LDMTR 

PURGSH 
THRESH 
BUFSIZ 
AUXSP(l) 

AUXSP(2) 

BLKSZE(l) 

BLKSZEC2) 

TCR 



ADDRESS 



MAXVOL 



SYSTEM 
CONTROL 
BLOCK 
AFFECTED 

+ 

CHBSYS 

CHBCCB 

CHBSYS 
CHBSYS 
CHBSYS 
CHBSYS 

CHBSYS 
CHBSYS 
CHBSYS 



CHBSYS 
CHBSOT 



CHBPVT 



number= f 1 ) 

21 

4J 



MODEL= 



U 



CHBCBT, 
CHBCBH, 
CHBCST 



DEFAULT 



10 

2% 

22 
10 
64 
JSYSBUF 

100 
12 

20 

55 
+ 1 

null 

4 

10 
j 



null 



null 
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GLOBAL SYMBOL 
TSKLMT 



JCCBCON 
JCCBMTT 
JCCBNCV 
JSYSTLM 

JCCBBAK 

JPAL1 

JSYSDAT 
JSYSPSL 

JSCMAUX 
JSYSXPG 



JSYSPS= 
PUBS EG 

JSYSPC= 
PACKSEG 

JSYSWA= 
WCDRUM 

JSYSWE= 
WCDISK 

JPAL4= 
SEGMENT 

JPAL5= 
integer value 



CCBSDST 

JSCMTIM 
JCCBBUF 



DESCRIPTION 



Specify Task Limitations 



Maximum number of conversational tasks 
that may exist concurrently 

Maximum number of MTT administrator 
tasks that may exist concurrently 

Maximum number of batch tasks 
that may exist concurrently 

Maximum number of conversational and 
batch tasks that can exist con- 
currently 

Maximum number of background tasks 
that may exist concurrently 

Maximum size of page tables 
for one task 

Number of entries to expand page table 

Maximum number of public segments 
allowed 

Present Aux storage space available 



Maximum number of pages that will 
trigger XTSI paging 

VMPAR j Specify Virtual Storage Parameters 



Public segment has sharable virtual 
storage routines 

Private modules page packed into 
segments 

Validity check paging drum writes 



Validity check auxiliary paging 
disk write 

Variable- length control sections 
are assigned a segment 

Variable- length control sections 
are assigned a segment (256 pages) 
or a specific number of pages 

Number of pages assigned to the 
shared data set table 

Task time interval 

Number of buffers for input data 



MACRO 
OPERAND 



CONV 



MTTADM 



BATCH 



BACK 

PGTBL 

VLPTE 
PSLMT 

OVRAUX 
XTSIPGS 



OPTIONS 

OPTIONS 

OPTIONS 

OPTIONS 

VCSLNG 

VCSLNG 

SDST 

TIME 
TBUFS 



T 

1 SYSTEM 

| CONTROL 

[ BLOCK 

[AFFECTED 
■+— 


- T — — n 

[DEFAULT | 

-+ -H 


1 CHBCCB 




| CHBCCB 




| CHBCCB 




| CHBSYS 




| CHBCCB 




1 CHBSYS 


116 | 


| CHBSYS 


|3 | 


1 CHBSYS 


[6 | 


| CHBSCM 


[-00 | 


I CHBSYS 


|0 1 

-+ 4 


| CHBSYS 


| null | 


| CHBSYS 


I null 1 


| CHBSYS 


| null | 


| CHBSYS 


[null 1 


| CHBCCB 


[SEGMENT | 


| CHBCCB 


120 | 


| CHBCCB 


110 | 


(CHBSCM 


[010000001 


| CHBCCB 


[200 | 
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APPENDIX C; 



DATA REFERENCES BY SYSTEM GENERATION MODULES 



This appendix presents a list of all DSECTs that are referred to by the System Genera- 
tion and Maintenance modules. The modules are listed by ID and the DSECTs by their sym- 
bolic names. Refer to the listings for further information. 



DSECT | CEIAA | CEIAP | CEIFA 
ID J (STARTUP) J (PRELUDE) | (SYSBLD) 

CHAAHD 1 | 

CHAASA | X | 
I + + „ 

CHAASB J X | 
+ + 

CHAASC | X j 

CHAAST | X | 

CHAAVE | | 

I- 



j Modules 



T" 



+ 

+ 



CEIDA 
(SYSGEN) 

_ + . 



AS AT Bit Directory 2311 
+ 



+ 



DSECT NAME 



4 

Available Devices Table Subqueue Header 



Auxiliary Storage Allocation 



ASAT Bit Directory 2314 



Auxiliary Segment Table 



Available Devices Table Subqueue Entries 



CHACBH | 
+- 

CHACBT j 

CHACCB j 
t +- 

CHACCC I 
h 



Core Block Table Header 



CHACHL I 

I- +- 

CHACST j 
CHACUT j 



X i 

x I 

i 

+- 



X 
X 



Core Block Table 






Configuration Control Block 



Catalog SBLOCK 



X | 



f 



Channel Table 
CPU Status Table 



CHADAV j 

CHADEV j 
| + . 

CHADSE | 

h +" 

CHADSF j 
,. + _ 

CHAECX | 
J. + . 

CHAGQE J 
j. + . 

CHAHED | 
+- 

CHAISA j 

CHAMAP j 
I- H 

chamch i 
I- +- 

CHAPGH | 

1 +- 

CHAPGT | 



I 



Control Unit Table 
DSCB Format C 






I 
X i 
X | 



Device Group Table 



X I 

x I 

! 

x I 

x I 
+ - 

I 
+- 















DSCB Format E 
+ 4 

DSCB Format F 

Support System Device Allocation Table 

General Queue Entry 
+ 



Available Device Table Header 



H 



+ 



+ 



Interruption Storage Area 



+ 



Memory Map Table 



CHAPOD I 
L A- 



X ) 

X | 
+- 






Multiplexer Channel Table 






PMD Group Header 
Page Table 



I 

-A- 



Partitioned Organization Directory 
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I 



"T" 
1 
h 



Modules 
r 



(DSECT 
| ID 

\- +■ 

JCHAPOE 

I + 

(CHAPOM 

H 



CEIAA J CEIAP 

CSTARTUP) | (PRELUDE) 

+ 



CEIFA 
(SYSBLD) 



CEIDA 
(SYSGEN) 



DSECT NAME 



1 



I 



Directory Alias Descriptor 



Directory Member Descriptor 



[CHAPSA 

| CHAPSD 

I 

(CHAPVT 
(. 



+ 



Prefixed Storage Area 



Direct Access Paging Statistical Data 
Record 
4 



[CHARJE 
(CHARSP 

|CHASAC 

I 

+ + + 






X 

X 






Public Volume Table 
Remote Job Entry Table 



4— 



Resident Shared- Page Index 






-4 



Symbolic to Actual Address Conversion 
Table 



| +CHASBD 
|. 

[CHASCH 



i 



SYSBLD Table 



Selector Channel Table 



I 



ICHASCM 

|CHASCN 

| + + _ 

1CHASDA | X | 



X 



X 
X 
X 



(System Common Table 
| Scan Table 



| CHASDS 

| 1- + - 



Symbolic Device Allocation Table 



— 4 



Shared Data Set Table 



JCHASDT 
| CHASGT 

|CHASID 

I" 

JCHASMC 

I 

(CHASOT 

|. 

I CHASST 

j. 

JCHASYS 

| CHATDE 



I/O Statistical Data Table 






+— 



Segment Table 



+- 

I 
+- 

I 
+- 



CHASOT Entry 



+ 

+ 









+— 



h 

j CHATDH 

CHATDT 



+- 



X I 
I 



+ 






Scan Master Control Table 



[System Operator ID Table 



System Statistics Table 

j System Table 
--+ 



4 

4 



Terminal Device Table 






TDY Heading 



Task Data Definition Table 



I 

j CHATDY 

| CHATSI 

\ — 

ICHAUSE 



-+- 



X | 



Task Dictionary Table 



+- 






Task Status Index 
User Table 



V 

JCHAVTC 
| 

JCHAXPT 
I 

j CHAXSP 
| 

ICHAXTS 



H- — 

i 
-+ 



DSCB Format 4 



X | 



X | 
| ^Internal to SYSBLD only 



+ 

+ 



External Page Table 
Shared External Page Table 



Extended Task Status Index 
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INDEX 



ACV path 7 

ACV volume 4,6 

Add pages to shared IVM 4 6 

ADDPGS 4 6 

ADDPMD 50 

Addressing capability (24- or 32-bit) 24 

Adjust DSCBs routine 7 

ALLOC 37 

Allocate SERR operating routine 31 

ANZSDA routine 30 

APGEN command procedure 55-56 

AS AT 30 

ASATRT 30 

ASDLST 23,28 

Assign external space routine 13 

AST 35,44 

ATRAN routine 49 

Auxiliary paging disks 29 

Auxiliary segment table 35,44 

Auxiliary storage alloc table 30 

Auxiliary storage device list 23,28 

Available device subqueue entry 9 7 

Available device subqueue header 96 

Available device table 96-97 



BDSDST 46 

Begin load list 36 

Begin task dictionary table 34,37 

BFP 20 

BFRPGET 27 

BGNLL 36 

BGNTDY 34,37 

BLDTBL 53 

BLDTDY 37 

BTRAN routine 49 

Buffer Cleanup routine CDSC20) 48 

Buffer page table 20 

Buffers, input to Startup 22 

Build RSS communication table 45 

Build shared data set table 46 

Build task dictionary table 37 

Bulk common table 100 



Calculate Checksum (DSCB75) 48 
Card reader path 4 f 7 
CBT (see CHBCBT) 
CCB (see CHBCCB) 

channel control unit table 98 

correspondence list 98 

CPU status table 97 

drum path table 98 

printer path table 98 

transmission control path table 98 
CCBCCT 10,98 
CCBCLT 26,98 
CCBCST 97 
CCBDPT 25,98 
CCBPRT 10,98 
CCBTPT 24,98 



CCU macro 54,101 


CEAAFQ 


22 


CEAA5P 


22 


CEAA5R 


22 


CEAA5S 


22 


CEAL1A 


22 


CEAMT1 


22 


CEIAA 


3,19,24-53 


CEIAB 


46-48 


CEIACC 


22 


CEIAP 


2,4,17-19 


CEIFA ( 


[see SYSBLD module) 


CEIFB 


6 


CEIFC 


6-7 


CEIFCKS 15 


CEIFD 


7 


CEIFDS 


15 


CEIFE 


10 


CEIFECAT 15 


CEIFF 


10-11 


CEIFG 


9 


CEIFI 


10 


CEIFJ 


11 


CEIFK 


11-12 


CEIFL 


12-13 


CEIFP 


6 


CEIFQ 


7 


CEIFR 


13-14 


CEIFRS1 15-16 


CEIFRS2 15-16 


CEIFS 


7,14-15 


CEIFT 


12 


CEIFTD 


11 


CEIFU 


13 


CEIFV 


13 


CEIFW 


13 


CEIFZA 


10 


CGCMA 


20,50 


CHASED 


6-7 


CHANNEL macro 54,101 


Channel control unit table 98 


Channel table 94 


CHBAHD 


9-10,96 


CHBAVE 


9-10,97 


CHBBFP 


19 


CHBBCT 


100 


CHBCBH 


99 


CHBCBT 


31,99 


CHBCCB 


10,97 


CHBCHL 


94 


CHBCUT 


9,95 


CHBDEV 


95 


CHBECX 


100 


CHBECXRA 100 


CHBECXRB 100 


CHBECXVA 100 


CHBHED 


96 


CHBMCH 


95 


CHBMTS 


20,21,27,31,38 


CHBPSD 


98 


CHBPVT 


100 


CHBRC 


36 
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CHBR5 36 

CHBRJE 100 

CHBRST 21,46 

CHBSAC 9 5 

CHBSCH 9 5 

CHBSCM 9 4 

CHBSCN 99 

CHBSDA 96 

CHBSDT 99 

CHBSID 9 6 

CHBSMC 9 8 

CHBSOT 96 

CHBSST 100 

CHBS2 8,9 

CHBS3 8,9 

CHBSYS 93 

CHBTCT 1 9 

CHBTDE 100 

CHBTDT ll f 20 

CHBVM 36 

Checksum routine 15,48 

CLOP macro 54 f 101 

COMAR 17 

Common disk channel 6 

Common disk control unit 7 

Communicate with operator routine 13-14 

Communication region 18 

Complete SYSBLD table routine 6-7 

Configuration control block 97 

Control unit table 95 

Convert paths routine 6 

Core block table 99 

Core block table header 99 

Correspondence list 98 

CPU macro 54,10 3 

CPU status table 97 

Create catalog routine 10-11 

Create extent table 36 

Create list of available drums 

routine 25-26 
Create format-E DSCB routine 47 
Create symbol table 50 
Create the resident shared page index 

table 52 
Create TDY storage map 40 
Create user library 10 
Create user table routine 10 
CRRSPI 52 
CST (see CCBCST) 
CTRAN 49 
CXD 26,38,39 

DAPSDR entry table, fields of 98 

DCU macro 54,103 

DEF, value of 39 

DEFINE 40 

DELBTB 43 

DELDS 43 

Delta data set routine (see DELDS, DELTBL, 

DELBTB) 
Delta data sets 26,43 
Delta volume 26,43 
DELTBL 43 

Demounting I PL or Delta volume 26 
Device group table 9 5 
DEVGRP macro 54,105 
Direct access paging statistical data 

record (see CHBPSD) 
Direct control switch 18 



DIRSIZ 


27 


Disk I/O routine 14-15 


DISPAR 


macro 55,107 


DMLST 


25-26 


Drum channel 7 


Drum c< 


Dntrol unit 7 


Drum device 7 


Drum path 5,7,10,23 


Drum path table (see CCBDPT) 


DSCBA 


47 


DSCBE 


46,47 


DSCBF 


47 


DSC20 


48 


DSC 2 5 


48 


DSC30 


46 


DSC 50 


48 


DSC60 


46,48 


DSC75 


48 


DSECTS 
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Dump/r es tor e 



EIAA2 50-51 

EIAA5 32-46 

Enable subroutine 24 

ENDABLE 32 

ERREXA 48 

Error Exit routine 48 

Extended task status index 44 

EXTENT 36 

External page table 40,42 



Find Format-E DSCB routine 15 

FIXPMD 38 

Form page table 41 

FORMPT 41 



Generalized I/O subroutine 

GENSCB macro 54-55 

Get a block of storage 52 

Get field routine 49 

GETEXT 41 

GETFLD 49 

GETMEM 52 

GETPAT 53 

Global symbols 55,101-109 



HASH routine 39-40 
Hole table entry 39 



50-51 



Initial program load (see IPL) 
Initial virtual storage (see 

TSS*****.SYSIVM> 
Initialization routine (see CEIFA) 
Initialize pathfinding tables 26-27 
Initialize reference entries in CSD 4 
Initialize SPT and XSPT for public 

segments 44-45 
Initialize the XTSI and page table pages 

44 
INTDE 27 

Inter- CPU communication 22 
Intercom routine 22 
Interrogate operator routine 6 
Interruption storage area 20,37 
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I/O statistical data table 

IPL 1,17 

IPL volume 4 

IPL volume path 6 

IPL volume path table 27 

ISA 20,37 

IVM (see TSS*****.SYSIVM) 
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Job file control block 
JFCB 11 
JPSA 31 



11 



41 



36 



LDPMD 37 

LINK 35 

Link-loader 32-46 

LLLNK 34 

LLSCAN 36-37 

Load and modify text 

Load and process load list 

Load PMD into TDY 37 

LOADL 36 

Load list 33,34,36-37 

LOADL 36 

Locate available page routine 

Locate DSCB Word routine 47 

Locate free page routine 47 

Locate DEF entry routine 12 

Locate descriptor in POD routine 

Locate name in TDY 40 

Locate XPT or XSPT origin 40-41 

LOCXPT 40-41 



48 



13 



CHBSCH, CHBS2, 



18 



Pathfinding routine 22 

Pathfinding tables (see CHBCHL, CHBCUT, 

CHBDEV, CHBMCH, CHBSAC, 

CHBS3) 
PGXTSI routine 27,30,44 
Prefix activation switch 
Prelude (see CEIAP) 
Primary paging volume 24 
Print storage map 50 
Print message routine 49 
PRINTER 49 

Printer control unit 7 
Printer device 4, 7 
Printer path table 98 

Process complex definitions in PMD 38 
Protection key 42 
Psudo-register value 26 
Public volume table 100 
PUBVOL macro 55,108 
PVT (see CHBPVT) 
P100X 25 
P400X 24 
P4800X 32 



Q-cons 26 

Q-ref 39 

QKREAD routine 46 

QSCNPSA routine 32 

Queue GQE on TSI 22 

Quickstart data set creator routine 46-48 

Quicks tart volume 46 

Quickstart 17 

Subroutines 46-48 



Main operator task 32 

Malfunction alert fields 21,27 

MAPGEN 40 

MEMAD 47 

MODFY 38-39 

Modify PMD and text pages 38-39 

MOT 3,32 

Move text (see MVTEXT) 

Mrs 21 

Multiplexer channel table 95 
Multiterminal Status Control Block 

(MTS) 21 
MVTEXT 49 



NAMLOC 40 



OPCNSL macro 54,108 

OPER 49 

Operator Device Path table 27 

Operator terminal 21,32 

Operator terminal path 6,27 

Operator's terminal I/O subroutine 49 

OUTPG 49 



Page conversion routine 

Page Status information 

Page TDY 53 

PAGTDY 53 

PAGRT 47 

PARTMP 32 

PATLOC 48 



12-13 
45 



RCOMTB 45 

RDSCB 52 

Read cards routine 49 

Read data set control block routine 52 

Read page assignment table routine 53 

Read in Quickstart data set routine 46 

Read from Quickstart volume 48 

Read page from IPL volume 43 

Read/Write operator routine 49 

READCARD 49 

READ IN 43 

Reconfiguration (see CGCMA) 

RECPG 48 

RELMEM 31,36 

Relocate TDY entries 41-42 

Relocation table processing 42 

RELTAB 42 

RELTBX 42 

RELTDY 41-42 

Remote Job Entry table (see CHBRJE) 

Reserve space for PMDs in TDY 50 

Resident shared page index 52 

Resident supervisor (see TSS*****.RESSUP) 

Resident support system (see 

TSS*****.RSSSUP> 
Reserve pages routine 27 
RESRVP 27 

RESSUP (see TSS*****,RESSUP) 
Reverse pathfinding 22 
RSPI 52 

RSS communication table 45 
RSS symbol table 21,46 
RSSCOM 45 
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RTAM Initialization 
RTAM tables 19,27 
RTMPGS 26 



19 



System programmer terminal 6-8 
System statistics table 100 
System table 93 



SAR 21,31 

Scan load list 36-37 

Scan master control table 98 

Scan table 99 

SCBTL 31 

SDAT 96 

SDATRT 28-30 

SDA500 28 

SDST 36,46 

Selective loading 33 

Selector channel table 95 

SERREND 51 

SERR/Reconfiguration path table 27 

SERR100 30,51 

Set external page number in XPT/XSPT 42-43 

Set path routine 22 

Set up volumes for startup routine 11 

SETPT 42-43 

SETPTH 26-27 

SETTSK 32 

Shared data set table 36,46 

Shared external page table (see XSPT) 

SHPTRT 44-45 

SIMFSA 24 

Skeletal extended task status index 44 

SOAPGS 31 

SORDID 50 

Special device path tables 20 

Special routine 27 

SPSABUF 32 

SSDAT (see CHBECXRA, CHBECXRB, CHBECXVA) 

Startup Communication Region 41 

Startup Prelude 11 

Startup routine 19 

STEM macro 54,108 

STERM 49 

Storage allocation for IVM and RESSUP 37 

Subqueue Headers table (see CHBAHD) 

Subqueue Entries table (see CHBAVE) 

Supervisor core allocation 22 

Support system device allocation 

header 100 
Support system device allocation table 100 
Symbolic device allocation table 96 
Symbolic-to-actual address conversion 

table 95 
SYMGEN 50 
SYSBLD table 6-7 
SYSBLD module 1,4-6 
SYSCAT 3 

SYSGEN. MODULE data set 3 
SYSMANGR 3,10,11 

USERLIB 3,5,10 
SYSOPER0 3,5,10,11 
SYSLOG 5 
USERLIB 3,5,10 
SYSSVCT 5 
System Activity and Resources table (see 

SAR) 
System buffer pages (see CHBBFP) 
System common table 94 
System generation macros 5^-55 
System operator ID table 96 
System operator ID table entry 96 



Task Core table (see CHBTCT) 

Task dictionary table 3 

Task initiation 22 

TDY 3,34,45,50 

TDYTAB 41,42 

Terminal device table 100 

Terminating routine 11-12 

Transmission control path table 98 

TSI 35 

TSKLMT macro 55,109 

TSS ***** 3,5,10,11 



TSS*****. 




APGEN ! 


55-56 


ASMMAC 


5 


ASMNDX 


5 


MACNDX 


5 


RESSUP 


3 


RSSSUP 


3 


STARTUP 


5,17 


SYSBLD 


5 


SYSCAT 


3 


SYSCCB 


3 


SYS IVM 


3 


SYSLIB 


5 


SYSMAC 


5 


SYSSVCT 


5 


SYSUSE 


3,5 


USERLIB 


3,5,10 



Update buffer location 48 
Update catalog JFCB routine 11 
Update catalog SBLOCK routine 15 
Update configuration control block 

routine 10 
Update device tables for RSS/VSS 15-16 
Update load list 37 
Update pathfinder tables routine 7 
Update virtual storage tables routine 9 
UPDLL 37 

User Catalogs Control Block (see SYSSVCT) 
User library (see TSS***** • USERLIB, 

SYSMANGR, USERLIB, SYSOPER0. USERLIB) 
User modules 20 
User table (see TSS*****. SYSUSE) 



Virtual storage support system allocation 

table 100 
VMPAR macro 55,109 



Write IVM page routine 47 
Write page on paging volume 49 
Write RESSUP /RSSSUP symbol table 45 
Write SERR/Reconfiguration modules on 

drums 51 
Write task dictionary table 45 
Write to Quickstart volume 48 
WRSYMTB 45 
WRTDY 45 
WRXTSI 29 



Index 115 



XPT 40,42 

XSPT 40,42,44 

XSPT entry converter routine 48 

XTSI 44 

XTSI buffer 27 

XTSIRT 44 
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